[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

emacs 21.0.101 documentation fixes for locale-related topics

From: Paul Eggert
Subject: emacs 21.0.101 documentation fixes for locale-related topics
Date: Wed, 28 Mar 2001 01:19:52 -0800 (PST)

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/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')
 %: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.
 A colon-separated list of directories in which to search for Info files.
 @item LC_ALL
address@hidden LC_COLLATE
 @itemx LC_CTYPE
address@hidden LC_MESSAGES
address@hidden LC_MONETARY
address@hidden LC_NUMERIC
address@hidden 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 @address@hidden, @address@hidden or
address@hidden@var{n}}, where @var{n} is between 1 and 4, automatically
-specifies the @address@hidden language environment when Emacs
-starts up.  There are a few extensions: if @var{n} is 9, that specifies
address@hidden, and if @var{n} is 14 or 15, that specifies
address@hidden 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,
address@hidden 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
address@hidden environment variable, or to the default @samp{C} locale if
address@hidden 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 @address@hidden 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
address@hidden and selects the corresponding language
address@hidden, 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 address@hidden
 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:
address@hidden 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
address@hidden 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
address@hidden 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.
 A description of what behavior you observe that you believe is

reply via email to

[Prev in Thread] Current Thread [Next in Thread]