From 641ba32982ab2129d3ad532a2289c87bf0847643 Mon Sep 17 00:00:00 2001
From: Corinna Vinschen <corinna@vinschen.de>
Date: Wed, 28 Oct 2009 10:09:54 +0000
Subject: [PATCH] 	* new-features.sgml (ov-new1.7-posix): Mention UTF-8
 as "C" default 	and the default locale "C.UTF-8". 	* setup2.sgml
 (setup-locale-ov): Ditto.

---
 winsup/doc/ChangeLog         | 6 ++++++
 winsup/doc/new-features.sgml | 4 +++-
 winsup/doc/setup2.sgml       | 8 +++++++-
 3 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 3a0e91322..e529b9ea4 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,9 @@
+2009-10-28  Corinna Vinschen  <corinna@vinschen.de>
+
+	* new-features.sgml (ov-new1.7-posix): Mention UTF-8 as "C" default
+	and the default locale "C.UTF-8".
+	* setup2.sgml (setup-locale-ov): Ditto.
+
 2009-10-26  Christopher Faylor  <me+cygwin@cgf.cx>
 
 	* faq-setup.xml: Fix clean_setup.pl reference.
diff --git a/winsup/doc/new-features.sgml b/winsup/doc/new-features.sgml
index dda067ac3..f38db1a75 100644
--- a/winsup/doc/new-features.sgml
+++ b/winsup/doc/new-features.sgml
@@ -211,7 +211,9 @@
   The setting of the environment variables $LANG, $LC_ALL or $LC_CTYPE will
   be used.  For instance, setting $LANG to "de_DE.ISO-8859-15" before
   starting a Cygwin session will use the ISO-8859-15 character set in
-  the entire session.  UTF-8 is supported as well, as in "en_US.UTF-8".
+  the entire session.  The default charset is "UTF-8", even in the
+  default locale "C".  The default locale in the absence of one of the
+  aforementioned environment variables is "C.UTF-8".
 
   The full list of supported character sets: "ASCII", "ISO-8859-x" with x
   in 1-16, except 12, "UTF-8", Windows codepages "CPxxx", with xxx in
diff --git a/winsup/doc/setup2.sgml b/winsup/doc/setup2.sgml
index 9c9e7a12d..99558f44f 100644
--- a/winsup/doc/setup2.sgml
+++ b/winsup/doc/setup2.sgml
@@ -180,6 +180,9 @@ variables to "C.charset".  For instance</para>
   "C.ISO-8859-1"
 </screen>
 
+<para>The default locale in the absence of the aforementioned locale
+environment variables is "C.UTF-8".</para>
+
 <para>Windows uses the UTF-16 charset exclusively to store the names
 of any object used by the Operating System.  This is especially important
 with filenames.  Cygwin uses the setting of the locale environment variables
@@ -206,7 +209,10 @@ own purpose, typically by using the call</para>
   setlocale (LC_ALL, "");
 </screen>
 
-<para>early in the application code.</para>
+<para>early in the application code.  Again, so that this doesn't get
+lost:  If the application calls setlocale as above, and there is none
+of the important locale variables set in the environment, the locale
+is set to the default locale, which is "C.UTF-8".</para>
 
 <para>
 Right now the language and territory, as well as the modifier, are not
-- 
2.43.5