diff options
| author | Sebastian Redl <sebastian.redl@getdesigned.at> | 2008-11-22 22:16:45 +0000 |
|---|---|---|
| committer | Sebastian Redl <sebastian.redl@getdesigned.at> | 2008-11-22 22:16:45 +0000 |
| commit | 6816856fb1feaf3a8add3d5cd99ec19339849c4e (patch) | |
| tree | f67d07ec52512c2377644462534967ddeadd3ca7 | |
| parent | 6dde0d5dc09f45f4d9508c964703e36fef1a0198 (diff) | |
Documentation for the plural modifier.
git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@59885 91177308-0d34-0410-b5e6-96231b3b80d8
| -rw-r--r-- | docs/InternalsManual.html | 33 |
1 files changed, 31 insertions, 2 deletions
diff --git a/docs/InternalsManual.html b/docs/InternalsManual.html index 6ecc5d6149..6434a910e1 100644 --- a/docs/InternalsManual.html +++ b/docs/InternalsManual.html @@ -3,6 +3,11 @@ <title>"clang" CFE Internals Manual</title> <link type="text/css" rel="stylesheet" href="../menu.css" /> <link type="text/css" rel="stylesheet" href="../content.css" /> +<style type="text/css"> +td { + vertical-align: top; +} +</style> </head> <body> @@ -253,9 +258,33 @@ Clang:</p> <tr><td>Description:</td><td>...</td></tr> <tr><td colspan="2"><b>"plural" format</b></td></tr> -<tr><td>Example:</td><td><tt>".."</tt></td></tr> +<tr><td>Example:</td><td><tt>"you have %1 %plural{1:mouse|:mice}1 connected to + your computer"</tt></td></tr> <tr><td>Classes:</td><td>Integers</td></tr> -<tr><td>Description:</td><td>...</td></tr> +<tr><td>Description:</td><td><p>This is a formatter for complex plural forms. + It is designed to handle even the requirements of languages with very + complex plural forms, as many Baltic languages have. The argument consists + of a series of expression/form pairs, separated by ':', where the first form + whose expression evaluates to true is the result of the modifier.</p> + <p>An expression can be empty, in which case it is always true. See the + example at the top. Otherwise, it is a series of one or more numeric + conditions, separated by ','. If any condition matches, the expression + matches. Each numeric condition can take one of three forms.</p> + <ul> + <li>number: A simple decimal number matches if the argument is the same + as the number. Example: <tt>"{1:mouse|:mice}"</tt></li> + <li>range: A range in square brackets matches if the argument is within + the range. Then range is inclusive both ends. Example: + <tt>"{0:none|1:one|[2,5]:some|:many}"</tt></li> + <li>modulo: A modulo operator is followed by a number, and equals sign + and either a number or a range. The tests are the same as for plain + numbers and ranges, but the argument is taken modulo the number first. + Example: <tt>"{%100=0:even hundred|%100=[1,50]:lower half|:everything + else}"</tt></li> + </ul> + <p>The parser is very unforgiving. A syntax error, even whitespace, will + abort, as will a failure to match the argument against any + expression.</p></td></tr> </table> |