Misleading documentation and usage of format_plural() function

Hi,

the documentation for the function format_plural($count, $singular, $plural) mentions that the singular string should be made very clear, to ease translation. The example given in the code is "1 new comment". Note that the $count parameter ("1") is hardcoded in the singular string. The plural string, however, uses correctly "%count new comments".

As a result, the translators do the same and use a fixed value in the singular string instead of the more flexible variable %count. Unfortunately, this approach does not work in all languages. Take for example French: In that language, the singular string is used for an amount of 0 and 1, the plural string is used for all values greater than one. In that language, the above mentioned example would produce a wrong translation for "0 new comments" ("1 nouveau commentaire" instead of "0 nouveau commentaire").

I propose to rephrase that part of the documentation, I've attached a patch to that effect.

I'd be happy to supply more patches for Drupal to replace the hardcoded count in singular strings with the %count parameter.