Describe the relationship between set-locale-environment and

set-language-environment, and why one might want to invoke
set-locale-environment.

diff --git a/man/ChangeLog b/man/ChangeLog
index 0d0f438d490b1a0a96e89e8a2278a57e0d4d0bbe..16316c879f406276cab4b86ac5cf1f1334723d59 100644 (file)
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,9 @@
+1999-11-20  Paul Eggert  <eggert@twinsun.com>
+
+       * mule.texi: Describe the relationship between
+       set-locale-environment and set-language-environment, and why
+       one might want to invoke set-locale-environment.
+
 1999-11-01  Eli Zaretskii <eliz@is.elta.co.il>
 
        * cc-mode.texi: Fix complaints from makeinfo 4.0.

diff --git a/man/mule.texi b/man/mule.texi
index 09962e3d111e338cc5183a8ad17f4a7bdc536a2a..72d1b5be715c5b206817ab43a59fe7e088179c4d 100644 (file)
--- a/man/mule.texi
+++ b/man/mule.texi
@@ -181,6 +181,17 @@ locale @samp{en_GB.ISO8859-15} matches @code{"Latin-1"} in
 @code{locale-charset-language-names}; since these two language
 environments' character sets disagree, Emacs uses @code{"Latin-9"}.
 
+  If all goes well, the @code{set-locale-environment} function selects
+the language environment, since language is part of locale.  It also
+adjusts the display table and terminal coding system, the locale coding
+system, and the preferred coding system as needed for the locale.
+
+  Since the @code{set-locale-environment} function is automatically
+invoked during startup, you normally do not need to invoke it yourself.
+However, if you modify the @env{LC_ALL}, @env{LC_CTYPE}, or @env{LANG}
+environment variables, you may want to invoke the
+@code{set-locale-environment} function afterwards.
+
 @findex set-locale-environment
 @vindex locale-preferred-coding-systems
   The @code{set-locale-environment} function normally uses the preferred