summaryrefslogtreecommitdiffstats
path: root/winsup/doc
diff options
context:
space:
mode:
Diffstat (limited to 'winsup/doc')
-rw-r--r--winsup/doc/ChangeLog4
-rw-r--r--winsup/doc/pathnames.xml19
2 files changed, 23 insertions, 0 deletions
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 362af7a4b..19f4d3ad5 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,7 @@
+2014-09-05 Corinna Vinschen <corinna@vinschen.de>
+
+ * pathnames.xml (cygdrive): Add /proc/cygdrive description.
+
2014-09-03 Corinna Vinschen <corinna@vinschen.de>
* utils.xml (setfacl): Align documentation to help text in setfacl.
diff --git a/winsup/doc/pathnames.xml b/winsup/doc/pathnames.xml
index b694c640a..412c98f43 100644
--- a/winsup/doc/pathnames.xml
+++ b/winsup/doc/pathnames.xml
@@ -355,6 +355,25 @@ the cygdrive prefix, use a distinct path prefix:</para>
D: /mnt/d somefs text 0 0
</screen>
+<para>To simplify scripting, Cygwin also provides a
+<filename>/proc/cygdrive</filename> symlink, which allows to use a fixed path
+in scripts, even if the actual cygdrive prefix has been changed, or is different
+between different users. So, in scripts, conveniently use the
+<filename>/proc/cygdrive</filename> symlink to successfully access files
+independently from the current cygdrive prefix:</para>
+
+<screen>
+ $ mount -p
+ Prefix Type Flags
+ /mnt user binmode
+ $ cat &gt; x.sh &lt;&lt;EOF
+ cd /proc/cygdrive/c/Windows/System32/Drivers/etc
+ ls -l hosts
+ EOF
+ $ sh -c ./x.sh
+ -rwxrwx---+ 1 SYSTEM SYSTEM 826 Sep 4 22:43 hosts
+</screen>
+
</sect2>
<sect2 id="pathnames-symlinks"><title>Symbolic links</title>