* pathnames.sgml: Add a note that ASCII SO handling isn't foolproof

	under all circumstances.

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index b49413d..370a5a3 100644 (file)
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,5 +1,10 @@
 2009-03-25  Corinna Vinschen  <corinna@vinschen.de>
 
+       * pathnames.sgml: Add a note that ASCII SO handling isn't foolproof
+       under all circumstances.
+
+2009-03-25  Corinna Vinschen  <corinna@vinschen.de>
+
        * new-features.sgml: Add missing GB2312 and eucKR character sets.
        * pathnames.sgml: Change "DOS devices" title to "Invalid filenames"
        and rephrase that section.

diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml
index 722c98b..2c47bc3 100644 (file)
--- a/winsup/doc/pathnames.sgml
+++ b/winsup/doc/pathnames.sgml
@@ -388,7 +388,12 @@ character, it skips over the ASCII SO and handles the following bytes as
 a UTF-8 character.  Thus, the filename is symmetrically converted back to
 UTF-16 and you can access the file.</para>
 
-<para>Again, by using UTF-8 you can avoid this problem entirely.</para>
+<note><para>Please be aware that this method is not entirely foolproof.
+In some character set combinations it might not work for certain native
+characters.</para>
+
+<para>Only by using the UTF-8 charset you can avoid this problem safely.
+</para></note>
 
 </sect2>