emacs 21.0.101 documentation fixes for locale-related topics

[Paul Eggert]

Here are some proposed patches to the Emacs 21.0.101 documentation for
locale-related topics.  They mostly just upgrade the documentation to
reflect Emacs's current behavior of looking at more of the locale.


diff -pru emacs-21.0.101/lisp/time-stamp.el 
emacs-21.0.101-fix/lisp/time-stamp.el
--- emacs-21.0.101/lisp/time-stamp.el   Mon Jan 29 08:58:40 2001
+++ emacs-21.0.101-fix/lisp/time-stamp.el       Tue Mar 27 09:36:10 2001
@@ -50,8 +50,9 @@ backward compatibility; see variable `ti
 
 A string is used verbatim except for character sequences beginning
 with %, as follows.  The values of non-numeric formatted items depend
-on the locale setting recorded in `locale-coding-system'.  The
-examples here are for the default (`C') locale.
+on the locale setting recorded in `system-time-locale' and
+`locale-coding-system'.  The examples here are for the default (`C')
+locale.
 
 %:a  weekday name: `Monday'.           %#A gives uppercase: `MONDAY'
 %3a  abbreviated weekday: `Mon'.       %3A gives uppercase: `MON'
diff -pru emacs-21.0.101/man/cmdargs.texi emacs-21.0.101-fix/man/cmdargs.texi
--- emacs-21.0.101/man/cmdargs.texi     Tue Mar 20 01:10:28 2001
+++ emacs-21.0.101-fix/man/cmdargs.texi Tue Mar 27 11:22:09 2001
@@ -362,18 +362,24 @@ to search for files.
 @item INFOPATH
 A colon-separated list of directories in which to search for Info files.
 @item LC_ALL
+@itemx LC_COLLATE
 @itemx LC_CTYPE
+@itemx LC_MESSAGES
+@itemx LC_MONETARY
+@itemx LC_NUMERIC
+@itemx LC_TIME
 @itemx LANG
-The user's preferred locale.  (The first of these environment
-variables with a nonempty value specifies the locale.)  A locale name
-which contains @samp{8859-@var{n}}, @samp{8859_@var{n}} or
-@samp{8859@var{n}}, where @var{n} is between 1 and 4, automatically
-specifies the @samp{Latin-@var{n}} language environment when Emacs
-starts up.  There are a few extensions: if @var{n} is 9, that specifies
-@samp{Latin-5}, and if @var{n} is 14 or 15, that specifies
-@samp{Latin-8} and @samp{Latin-9}, respectively.
+The user's preferred locale.  The locale has six categories, specified
+by the environment variables @env{LC_COLLATE} for sorting,
+@env{LC_CTYPE} for character encoding, @env{LC_MESSAGES} for system
+messages, @env{LC_MONETARY} for monetary formats, @env{LC_NUMERIC} for
+numbers, and @env{LC_TIME} for dates and times.  If one of these
+variables is not set, the category defaults to the value of the
+@env{LANG} environment variable, or to the default @samp{C} locale if
+@env{LANG} is not set.  But if @env{LC_ALL} is specified, it overrides
+the settings of all the other locale environment variables.
 
-The locale value you specify with one of these three variables is
+The value of the LC_CTYPE category is
 matched against entries in @code{locale-language-names},
 @code{locale-charset-language-names}, and
 @code{locale-preferred-coding-systems}, to select a default language
diff -pru emacs-21.0.101/man/mule.texi emacs-21.0.101-fix/man/mule.texi
--- emacs-21.0.101/man/mule.texi        Tue Mar 20 01:10:29 2001
+++ emacs-21.0.101-fix/man/mule.texi    Tue Mar 27 11:11:41 2001
@@ -230,13 +230,14 @@ package, which includes fonts for all su
 @vindex locale-language-names
 @vindex locale-charset-language-names
 @cindex locales
-  Some operating systems let you specify the language you are using by
+  Some operating systems let you specify the character locale you are using by
 setting the locale environment variables @env{LC_ALL}, @env{LC_CTYPE},
 or @env{LANG}.@footnote{If more than one of these is set, the first
-one that is nonempty specifies your locale for this purpose.}  Emacs
-handles this during startup by matching your locale against entries in
+one that is nonempty specifies your locale for this purpose.}  During
+startup, Emacs looks up your character locale's name in the system
+locale alias table, matches the canonical name against entries in
 the value of the variables @code{locale-charset-language-names} and
-@code{locale-language-names} and selects the corresponding language
+@code{locale-language-names}, and selects the corresponding language
 environment if a match is found.  (The former variable overrides the
 latter.)  It also adjusts the display table and terminal coding
 system, the locale coding system, and the preferred coding system as
diff -pru emacs-21.0.101/man/trouble.texi emacs-21.0.101-fix/man/trouble.texi
--- emacs-21.0.101/man/trouble.texi     Wed Mar 14 00:46:54 2001
+++ emacs-21.0.101-fix/man/trouble.texi Tue Mar 27 09:45:47 2001
@@ -648,18 +648,11 @@ stimulates the bug.@refill
 @item
 If non-ASCII text or internationalization is relevant, the locale that
 was current when you started Emacs.  On GNU/Linux and Unix systems, or
-if you use a Unix-style shell such as Bash, you can use this shell
-command to view the relevant values:
-
-@example
-echo LC_ALL=$LC_ALL LC_CTYPE=$LC_CTYPE LANG=$LANG
-@end example
-
-You can use the @kbd{M-!} command to execute the shell command from
+if you use a Unix-style shell such as Bash, you can use the
+@command{locale} command to view the relevant values.
+You can use the @kbd{M-!} command to execute the @command{locale} command from
 Emacs, and then copy the output from the @samp{*Messages*} buffer into
-the bug report.  Alternatively, @kbd{M-x getenv @key{RET} LC_ALL
-@key{RET}} will print the value of @code{LC_ALL} in the echo area, and
-you can copy its output from the @samp{*Messages*} buffer.
+the bug report.
 
 @item
 A description of what behavior you observe that you believe is