Tweak doc of chapter "Users".

diff --git a/gettext-tools/doc/gettext.texi b/gettext-tools/doc/gettext.texi
index 108fdd761ee0f363a592b396e31cfc0704ed394f..fe7959067527a48fd63aa333ecf70791847ac5e1 100644 (file)
--- a/gettext-tools/doc/gettext.texi
+++ b/gettext-tools/doc/gettext.texi
@@ -1218,6 +1218,15 @@ On other systems, some variations of this scheme are used, such as
 @samp{@var{ll}}.  You can get the list of locales supported by your system
 for your language by running the command @samp{locale -a | grep '^@var{ll}'}.
 
+There is also a special locale, called @samp{C}.
+@c Don't mention that this locale also has the name "POSIX". When we talk about
+@c the "POSIX locale", we mean the "locale as specified in the POSIX way", and
+@c mentioning a locale called "POSIX" would bring total confusion.
+When it is used, it disables all localization: in this locale, all programs
+standardized by POSIX use English messages and an unspecified character
+encoding (often US-ASCII, but sometimes also ISO-8859-1 or UTF-8, depending on
+the operating system).
+
 @node Locale Environment Variables, The LANGUAGE variable, Locale Names, Setting the POSIX Locale
 @subsection Locale Environment Variables
 @cindex setting up @code{gettext} at run time
@@ -1306,6 +1315,11 @@ For example, @samp{de} is equivalent to @samp{de_DE} (German as spoken in
 Germany), and @samp{pt} to @samp{pt_PT} (Portuguese as spoken in Portugal)
 in this context.
 
+Note: The variable @code{LANGUAGE} is ignored if the locale is set to
+@samp{C}.  In other words, you have to first enable localization, by setting
+@code{LANG} (or @code{LC_ALL}) to a value other than @samp{C}, before you can
+use a language priority list through the @code{LANGUAGE} variable.
+
 @node Installing Localizations,  , Setting the POSIX Locale, Users
 @section Installing Translations for Particular Programs
 @cindex Translation Matrix