From 92fa4552fdec83d9d7eb9100f7584c560d9ba37e Mon Sep 17 00:00:00 2001 From: Corinna Vinschen Date: Tue, 3 Mar 2009 10:36:59 +0000 Subject: [PATCH] * faq-using.xml: Rework UTF FAQ to accommodate latest setlocale change in newlib. --- winsup/doc/ChangeLog | 5 +++++ winsup/doc/faq-using.xml | 19 ++++++++++++++----- 2 files changed, 19 insertions(+), 5 deletions(-) diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index 903bf376a..cadc9ed0c 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,8 @@ +2009-03-03 Corinna Vinschen + + * faq-using.xml: Rework UTF FAQ to accommodate latest setlocale + change in newlib. + 2009-03-03 Corinna Vinschen * pathnames.sgml: Remove reference to managed mountpoints in mount diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml index ea2b9044a..c2f83848f 100644 --- a/winsup/doc/faq-using.xml +++ b/winsup/doc/faq-using.xml @@ -368,11 +368,20 @@ formfeed character to your file. Internationalization is a complex issue. The short answer is that Cygwin relies on the setting of the CYGWIN environment variable as well -as on the setting of LANG environment variable. The underlying C library, -newlib, only supports a small subset of LANG settings. The default is "C". -To get UTF-8 support you must set LANG to "C-UTF-8" and CYGWIN so that -it contains "codepage:utf8". - +as on the setting of LANG/LC_xxx environment variables. + +To get UTF-8 support you must set the environment variable CYGWIN +so that it contains the substring "codepage:utf8". This is required in +Cygwin so far to get correct translation from Windows wide character +filenames to their UTF-8 counterpart. Applications on the other hand +require the setting of the LANG, LC_ALL, or LC_CTYPE environment variables. +To get UTF-8 support you can set, for instance, $LANG to "en_US.UTF-8". +This will give you support for the UTF-8 character set. Note that the +language part has to contain a valid language specifier, but is otherwise +so far ignored by newlib, the underlying C library. There's no support +for correct language-specific collation, monetary or date/time-related +string handling. This is planned for a later release, though. + To type international characters (£äö) in bash, add the following lines to your ~/.inputrc file and restart bash: