Describe the relationship between set-locale-environment and

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

2 files changed, 17 insertions, 0 deletions

diff --git a/man/ChangeLog b/man/ChangeLog
index 0d0f438d490..16316c879f4 100644
--- 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 09962e3d111..72d1b5be715 100644
--- 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