[Python-checkins] cpython: Close #6203: Document that Python 3 sets LC_CTYPE at startup to the user's

[victor.stinner]

http://hg.python.org/cpython/rev/113cdce4663c
changeset:   77366:113cdce4663c
user:        Victor Stinner <victor.stinner at gmail.com>
date:        Wed Jun 06 01:37:37 2012 +0200
summary:
  Close #6203: Document that Python 3 sets LC_CTYPE at startup to the user's preferred locale encoding

files:
  Doc/library/locale.rst |  7 +++++--
  1 files changed, 5 insertions(+), 2 deletions(-)


diff --git a/Doc/library/locale.rst b/Doc/library/locale.rst
--- a/Doc/library/locale.rst
+++ b/Doc/library/locale.rst
@@ -475,8 +475,11 @@
 locale somewhat painful to use correctly.
 
 Initially, when a program is started, the locale is the ``C`` locale, no matter
-what the user's preferred locale is.  The program must explicitly say that it
-wants the user's preferred locale settings by calling ``setlocale(LC_ALL, '')``.
+what the user's preferred locale is.  There is one exception: the
+:data:`LC_CTYPE` category is changed at startup to set the current locale
+encoding to the user's preferred locale encoding. The program must explicitly
+say that it wants the user's preferred locale settings for other categories by
+calling ``setlocale(LC_ALL, '')``.
 
 It is generally a bad idea to call :func:`setlocale` in some library routine,
 since as a side effect it affects the entire program.  Saving and restoring it

-- 
Repository URL: http://hg.python.org/cpython