OSDN Git Service

* faq-using.xml: Fix typos and remove incorrect locale-specific
authorcorinna <corinna>
Mon, 25 Jan 2010 10:50:21 +0000 (10:50 +0000)
committercorinna <corinna>
Mon, 25 Jan 2010 10:50:21 +0000 (10:50 +0000)
documentation.
* new-features.sgml: Ditto.
* pathnames.sgml: Ditto.

winsup/doc/ChangeLog
winsup/doc/faq-using.xml
winsup/doc/new-features.sgml
winsup/doc/pathnames.sgml

index 02833db..61425a1 100644 (file)
@@ -1,3 +1,10 @@
+2010-01-25  Andy Koppe  <andy.koppe@gmail.com>
+
+       * faq-using.xml: Fix typos and remove incorrect locale-specific
+       documentation.
+       * new-features.sgml: Ditto.
+       * pathnames.sgml: Ditto.
+
 2010-01-24  Corinna Vinschen  <corinna@vinschen.de>
 
        * new-features.sgml: Rework layout to use itemizedlist.  Fix typo.
index 64a7cee..ad8a928 100644 (file)
@@ -362,13 +362,8 @@ variables. The long answer can be found in the User's Guide in the
 section <ulink url="http://cygwin.com/cygwin-ug-net/setup-locale.html">Internationalization</ulink>
 </para>
 
-<para>To get UTF-8 support you must set 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.  There's no support for correct
-language-specific collation, monetary or date/time-related
-string handling.  This is planned for a later release, though.</para>
+<para> Cygwin uses UTF-8 by default.  To use a different character set, you
+need to set the LC_ALL, LC_CTYPE or LANG environment variables.</para>
 
 <para>To type international characters (&pound;&auml;&ouml;) in
 <literal>bash</literal>, check if the following settings are available in
@@ -400,10 +395,10 @@ alias ls='/bin/ls -F --color=tty --show-control-chars'
 <question><para>My application prints international characters but I only
 see gray boxes</para></question>
 <answer>
-<para>Very likely you didn't set your Console character set to the preferred
+<para>Very likely you didn't set your console character set to the preferred
 character set before the first Cygwin application was started in the
 console.  To make sure the console is using the desired character set,
-maile sure that one of the internationalization environment variables
+make sure that one of the internationalization environment variables
 LC_ALL, LC_CTYPE, or LANG is set before the first Cygwin process starts.
 You can do that, for instance, by setting the variable in your
 <literal>Cygwin.bat</literal> file from which you start your Cygwin shell.
index 8c09db0..d495055 100644 (file)
 
   <listitem><para>
   Cygwin now handles locales using the underlying Windows locale
-  support.  The locale must exists in Windows to be recognized.
+  support.  The locale must exist in Windows to be recognized.
   </para></listitem>
 
   <listitem><para>
-  New tool "getlocale" to fetch valid locale values from Windows.
+  New tool "getlocale" to fetch valid locale identifiers from Windows.
   </para></listitem>
 
   <listitem><para>
-  Default charset for locales without explicit charset is now choosen
+  Default charset for locales without explicit charset is now chosen
   from a list of Linux-compatible charsets.
   </para>
   
@@ -32,7 +32,7 @@
 
   <listitem><para>
   Default charset in the "C" or "POSIX" locale has been changed back
-  from UTF-8 to ASCII, to circumvent problems with applications
+  from UTF-8 to ASCII, to avoid problems with applications
   expecting a singlebyte charset in the "C"/"POSIX" locale.  Still use
   UTF-8 internally for filename conversion in this case.
   </para></listitem>
   New strfmon(3) call.
   </para></listitem>
 
+  <listitem><para>
+  The console's backspace keycode can be changed using 'stty erase'.
+  </para></listitem>
+
   </itemizedlist>
 
 </listitem>
@@ -110,7 +114,7 @@ If a filename cannot be represented in the current character set, the
 character will be converted to a sequence Ctrl-X + UTF-8 representation
 of the character.  This allows to access all files, even those not
 having a valid representation of their filename in the current character
-set (codepage).  To always have a valid string, use the UTF-8 charset by
+set.  To always have a valid string, use the UTF-8 charset by
 setting the environment variable $LANG, $LC_ALL, or $LC_CTYPE to a valid
 POSIX value, for instance in Cygwin.bat like this:
 </para>
@@ -159,8 +163,8 @@ Creating files with special DOS device filename components ("aux",
 <listitem><para>
 File names are case sensitive if the OS and the underlying file system
 supports it.  Works on NTFS and NFS.  Does not work on FAT and Samba
-shares.  Requires to change a registry key (see the user's guide).  Can
-be switched off on a per-mount base.
+shares.  Requires to change a registry key (see the User's Guide).  Can
+be switched off on a per-mount basis.
 </para></listitem>
 
 <listitem><para>
@@ -302,7 +306,7 @@ New send/recv option MSG_DONTWAIT.
 </para></listitem>
 
 <listitem><para>
-IPv6 support.  New API getaddrinfo, getnameinfo, freeaddrinfo,
+IPv6 support.  New APIs getaddrinfo, getnameinfo, freeaddrinfo,
 gai_strerror, in6addr_any, in6addr_loopback.  On IPv6-less systems,
 replacement functions are available for IPv4.  On systems with IPv6
 enabled, the underlying WinSock functions are used.  While I tried hard
@@ -410,8 +414,7 @@ A lot of character sets are supported now via a call to setlocale().
 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.  The default charset is "UTF-8", even in the default
-locale "C".  The default locale in the absence of one of the
+entire session.  The default locale in the absence of one of the
 aforementioned environment variables is "C.UTF-8".
 </para>
 
@@ -420,9 +423,7 @@ 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
 (437, 720, 737, 775, 850, 852, 855, 857, 858, 862, 866, 874, 1125, 1250,
 1251, 1252, 1253, 1254, 1255, 1256, 1257, 1258), "KOI8-R", "KOI8-U",
-"SJIS", "GBK", "eucJP", "eucKR", and "Big5".  The leading language and
-territory part (en_US, for instance) is not used by Cygwin yet, but is
-required for POSIX compatibility.
+"SJIS", "GBK", "eucJP", "eucKR", and "Big5".
 </para>
 
 </listitem>
index 4cca824..d65f016 100644 (file)
@@ -403,22 +403,12 @@ Converting backslashes using the above method would make this impossible.</para>
 <sect2 id="pathnames-unusual">
 <title>Filenames with unusual (foreign) characters</title>
 
-<para> Windows filesystems use the Unicode character set in the UTF-16
-encoding to store filename information.  If you don't use the UTF-8
+<para> Windows filesystems use Unicode encoded as UTF-16
+to store filename information.  If you don't use the UTF-8
 character set (see <xref linkend="setup-locale"></xref>) then there's a
 chance that a filename is using one or more characters which have no
 representation in the character set you're using.</para>
 
-<para>For instance, there are no Chinese characters in the ISO-8859-1
-character set.  So, converting a filename containing a Chinese character
-to ISO-8859-1 leaves you with a wrongly converted filename, for instance,
-containing a question mark '?' as replacement for the unconvertable
-character.  When trying to access the file, Cygwin has to convert the
-filename back to UTF-16.  However, this doesn't result in the original
-filename because the question mark will not translate back to the original
-Chinese character, but to a simple question mark instead.  This in turn
-results in strange "File not found" messages.</para>
-
 <note><para>In the default "C" locale, Cygwin creates filenames using
 the UTF-8 charset.  This will always result in some valid filename by
 default, but again might impose problems when switching to a non-"C"