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 0d0f438..16316c8 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 09962e3..72d1b5b 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