summaryrefslogtreecommitdiff
path: root/doc/ref/guile-invoke.texi
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2011-11-22 12:11:48 +0100
committerAndy Wingo <wingo@pobox.com>2013-03-07 10:48:44 +0100
commit7f893030abaf49711f948d76f124e18bfa9e4181 (patch)
tree62e4bd2fb8a89e7eb85efe3aa988b19e22b611b4 /doc/ref/guile-invoke.texi
parent1b787ef9ec3a08f12d7b46403f4d508e583499a2 (diff)
downloadguile-7f893030abaf49711f948d76f124e18bfa9e4181.tar.gz
Install the current locale if GUILE_INSTALL_LOCALE is nonzero.
* libguile/guile.c (get_integer_from_environment) (should_install_locale): New functions. (main): Add `setlocale' call. * doc/ref/guile-invoke.texi (Environment Variables): Add documentation.
Diffstat (limited to 'doc/ref/guile-invoke.texi')
-rw-r--r--doc/ref/guile-invoke.texi18
1 files changed, 17 insertions, 1 deletions
diff --git a/doc/ref/guile-invoke.texi b/doc/ref/guile-invoke.texi
index 5a9a3f7ef..7cf4c9f88 100644
--- a/doc/ref/guile-invoke.texi
+++ b/doc/ref/guile-invoke.texi
@@ -1,6 +1,6 @@
@c -*-texinfo-*-
@c This is part of the GNU Guile Reference Manual.
-@c Copyright (C) 1996, 1997, 2000, 2001, 2002, 2003, 2004, 2005, 2010, 2011
+@c Copyright (C) 1996, 1997, 2000, 2001, 2002, 2003, 2004, 2005, 2010, 2011, 2013
@c Free Software Foundation, Inc.
@c See the file guile.texi for copying conditions.
@@ -291,6 +291,22 @@ This variable names the file that holds the Guile REPL command history.
You can specify a different history file by setting this environment
variable. By default, the history file is @file{$HOME/.guile_history}.
+@item GUILE_INSTALL_LOCALE
+@vindex GUILE_INSTALL_LOCALE
+This is a flag that can be used to tell Guile whether or not to install
+the current locale at startup, via a call to @code{(setlocale LC_ALL
+"")}. @xref{Locales}, for more information on locales.
+
+You may explicitly indicate that you do not want to install
+the locale by setting @env{GUILE_INSTALL_LOCALE} to @code{0}, or
+explicitly enable it by setting the variable to @code{1}.
+
+Usually, installing the current locale is the right thing to do. It
+allows Guile to correctly parse and print strings with non-ASCII
+characters. However, for compatibility with previous Guile 2.0
+releases, this option is off by default. The next stable release series
+of Guile (the 2.2 series) will install locales by default.
+
@item GUILE_LOAD_COMPILED_PATH
@vindex GUILE_LOAD_COMPILED_PATH
This variable may be used to augment the path that is searched for