Skip to content

Commit 20ae95e

Browse files
authored
CLDR-19290 Update plural-rules.md (#5432)
1 parent 417e136 commit 20ae95e

File tree

1 file changed

+58
-5
lines changed

1 file changed

+58
-5
lines changed

docs/site/index/cldr-spec/plural-rules.md

Lines changed: 58 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -44,18 +44,71 @@ with an extra one for fractions. For example:
4444

4545
## Determining Plural Categories
4646

47-
The CLDR plural categories do not necessarily match the traditional grammatical categories. Instead, the categories are determined by changes required in a phrase or sentence if a numeric placeholder changes value. 
47+
The CLDR plural categories do not necessarily match the traditional grammatical categories.
48+
Instead, the categories are determined by changes required in a phrase or sentence if a numeric placeholder changes value.
49+
That numeric placeholder is represented by {0}, and will be replaced by a series of digits.
4850

4951
### Minimal pairs
5052

51-
The categories are verified by looking a minimal pairs: where a change in numeric value (expressed in digits) forces a change in the other words. For example, the following is a minimal pair for English, establishing a difference in category between "1" and "2".
53+
For both plurals (aka cardinals) and ordinals, CLDR requires what are called _minimal pairs_, both to justify and verify the categories, and to supply examples for vetters.
54+
A set of minimal pairs provides one example per category, where a change in numeric value (expressed in digits) forces a change in the other words.
55+
Although the term used is _minimal pairs_, this refers to pairwise differences; the set of minimal pairs for a given language might be as many as 6 examples.
56+
There are three general types of appoaches to this: *noun changes*, *verb changes*, and *pronoun changes*.
57+
58+
When creating minimal pairs, often vetters try noun changes, and don't find any in their language.
59+
They then give up and say that there are no minimal pairs for their languages.
60+
When the software requires them to provide minimal pairs, they then provide bad examples.
61+
The following examples illustrate the approaches, and the subsequent sections provide details.
62+
63+
#### Noun Changes
64+
Do nouns change if an associated number changes?
65+
66+
| Category | Resolved String | Minimal Pair Template |
67+
|---|---|---|
68+
| one | 1 day | {0} day |
69+
| other | 2 day<b>s</b> | {0} day<b>s</b> |
70+
71+
When trying to create minimal pairs, check different nouns in your language.
72+
If your language has gender or grammatical cases for nouns, try phrases with nouns of different genders or different cases.
73+
For example, in some languages neuter nouns might not change with numbers, but masculine nouns might; or phases where the noun is genitive might.
74+
Remember that there must be no semantic differences in the phrases for each category *other than those required by a change in the number*.
75+
Note also that the noun must be one that works in your language: it does *not* have to match the English noun.
76+
More details are below.
77+
78+
#### Verb Changes
79+
In some languages, no nouns change with numbers: they are all like the English noun "sheep".
80+
81+
| Category | Resolved String | Minimal Pair Template |
82+
|---|---|---|
83+
| one | 1 sheep | {0} sheep |
84+
| other | 2 sheep | {0} sheep |
85+
86+
For those languages, _verb changes_ may be needed to demonstrate changes between categories.
87+
88+
| Category | Resolved String | Minimal Pair Template |
89+
|---|---|---|
90+
| one | 1 sheep _is_ here | {0} sheep _is_ here |
91+
| other | 2 sheep _are_ here | {0} sheep _are_ here |
92+
93+
#### Pronoun Changes
94+
In some languages, neither nouns nor verbs ever change with numbers: they are all like "sheep" and "will be".
5295

5396
| Category | Resolved String | Minimal Pair Template |
5497
|---|---|---|
55-
| one | 1 day | {NUMBER} day |
56-
| other | 2 day s | {NUMBER} day s |
98+
| one | 1 sheep will be here | {0} sheep will be here |
99+
| other | 2 sheep will be here | {0} sheep will be here |
100+
101+
For those languages, _pronoun reference_ changes may be needed to demonstrate changes between categories, where a pronoun references the noun associated with the number.
102+
103+
| Category | Resolved String | Minimal Pair Template |
104+
|---|---|---|
105+
| one | 1 sheep will be here; will you see _it_? | {0} sheep will be here; will you see _it_? |
106+
| other | 2 sheep will be here; will you see _them_? | {0} sheep will be here; will you see _them_? |
107+
108+
#### Other Changes
109+
In some languages, other grammatical constructions may be needed to verify the categories.
57110

58-
Warning for Vetters
111+
### Warning for Vetters
59112

60113
The Category (Code) values indicate a certain range of numbers that differ between languages. To see the meaning of each Code value for your language see [Language Plural Rules](https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html) chart.
61114

0 commit comments

Comments
 (0)