GNU Gettext manal, 0.11.2

[Peter Miller]

Have been reading the GNU Gettext manual, version 0.11.2.

7 "Manipulating PO Files" fails to mention the msgmerge program.
There is a texi file for msgmerge, it just needs @including like all the
other commands.  A cross reference from the msgmerge command to 6.11
"Using translation compendia" would also be useful (and vice versa).

10.2.5 "Additional functions for plural forms"
This needs pointers to 2.2 "The format of PO files" and also 8.3 "The
format of GNU MO files".

Some examples of plural PO input and the resulting strings in the MO
file would also be helpful.

The paragraph following "Plural-Forms: nplurals=2; plural=n == 1 ? 0 :
1"
which starts "The nplurals value must be a decimal number  which..."
needs much more detail.   To say that "The expression following plural
is an expression which is using the C language syntax" is insufficient:
*which* operators are supported?  By reading the code I was able to
determine that + - * / % && || ! < <= > >= == != ?: () are the only
operators supported.  This is a *subset* of C language syntax.  The
manual should state the operators explicitly.

Also, there is a bug: ngettext will crash your program if a divide or
modulo zero occurs.  This would be bad.  The conventional cop-out is to
evaluate such expresions to zero.

The manual needs to explicity state that a syntax error results in N=0
(the singular form) being used.
It needs to state that if N>=nplurals, N=0 is used.
It needs to state that if msg_str[N] is not present, N=0 is used.

In the examples of language forms, Russian is a nplurals=5 example.
(One of the translators for Aegis speaks Russian, I do not.) 

8.3 "The format of GNU MO files"
Additional section numbers may help here.
one for plurals,
and another for the discussion of NULs.
(How would these two interact???)

9 "The User's View"
I have recently had large amounts of trouble getting GNU Gettext to work
on Solaris.  When I consulted the code, there does not appear to be an
(environment) variable I can set so that GNU Gettext's searches for
message catalogues (hits *and* misses) are echoed to stderr, so that I
can see where the problem is.  Could this feature be added, please?

9.3 "magic for end users"
Surely the LANGUAGES environment variable should be mentioned, too?