Welcome to mirror list, hosted at ThFree Co, Russian Federation.

cygwin.com/git/newlib-cygwin.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
path: root/winsup
diff options
context:
space:
mode:
authorCorinna Vinschen <corinna@vinschen.de>2009-10-09 15:19:18 +0400
committerCorinna Vinschen <corinna@vinschen.de>2009-10-09 15:19:18 +0400
commit220f363d20cf63e78887212d86fa966e794c8030 (patch)
tree382eaa8bb99428f0f6ca7d58bd6e081c65f1359d /winsup
parent9fa1c6420b3ca962e0e758f5ddd400fc9c8a408e (diff)
* pathnames.sgml (pathnames-specialchars): Add control chars to the
list. Explain backslash exception.
Diffstat (limited to 'winsup')
-rw-r--r--winsup/doc/ChangeLog5
-rw-r--r--winsup/doc/pathnames.sgml9
2 files changed, 13 insertions, 1 deletions
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index c8655e97d..646d584bb 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,8 @@
+2009-10-09 Corinna Vinschen <corinna@vinschen.de>
+
+ * pathnames.sgml (pathnames-specialchars): Add control chars to the
+ list. Explain backslash exception.
+
2009-10-03 Dave Korn <dave.korn.cygwin@gmail.com>
* faq-using.xml (faq.using.bloda): Add Lenovo IPS Core Service.
diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml
index 527096fcb..cb8365b97 100644
--- a/winsup/doc/pathnames.sgml
+++ b/winsup/doc/pathnames.sgml
@@ -379,7 +379,10 @@ all of them are removed before the file is created. This restriction only
affects native Win32 applications. Cygwin applications can create and
access files with trailing dots and spaces without problems.</para>
-<para>Some characters are disallowed in filenames on Windows filesystems:</para>
+<para>Additionally, some characters are disallowed in filenames on Windows
+filesystems. These forbidden characters are the ASCII control characters
+from ASCII value 1 to 31, plus the following charcters which have a special
+menaing in the Win32 API:</para>
<screen>
" * : &lt; &gt; ? | \
@@ -390,6 +393,10 @@ restriction. All of the above characters, except for the backslash,
are converted to special UNICODE characters in the range 0xf000 to 0xf0ff
(the "Private use area") when creating or accessing files.</para>
+<para>The backslash has to be exempt from this conversion, because Cygwin
+accepts Win32 filenames including backslashes as path separators on input.
+Converting backslashes using the above method would make this impossible.</para>
+
</sect2>
<sect2 id="pathnames-unusual">