From 841003a9b30bb82dc304fea3d7fba07205ab2795 Mon Sep 17 00:00:00 2001
From: Corinna Vinschen <corinna@vinschen.de>
Date: Wed, 11 Aug 2010 11:12:10 +0000
Subject: [PATCH] 	* new-features.sgml (ov-new1.7.6): Document "bind"
 option. 	* pathnames.sgml (mount-table): Add "bind" option with
 example.

---
 winsup/doc/ChangeLog         |  5 +++++
 winsup/doc/new-features.sgml |  5 +++++
 winsup/doc/pathnames.sgml    | 18 ++++++++++++++++++
 3 files changed, 28 insertions(+)

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 4dcee95e9..2bbe05395 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,8 @@
+2010-08-11  Corinna Vinschen  <corinna@vinschen.de>
+
+	* new-features.sgml (ov-new1.7.6): Document "bind" option.
+	* pathnames.sgml (mount-table): Add "bind" option with example.
+
 2010-08-09  Yaakov Selkowitz  <yselkowitz@users.sourceforge.net>
 
 	* new-features.sgml (ov-new1.7.6): Document POSIX monotonic clock.
diff --git a/winsup/doc/new-features.sgml b/winsup/doc/new-features.sgml
index d35feaf51..049183f54 100644
--- a/winsup/doc/new-features.sgml
+++ b/winsup/doc/new-features.sgml
@@ -9,6 +9,11 @@ Add new mount options "dos" and "ihash" to allow overriding Cygwin default
 behaviour on broken filesystems not recognized by Cygwin.
 </para></listitem>
 
+<listitem><para>
+Add new mount option "bind" to allow remounting parts of the POSIX file
+hirarchy somewhere else.
+</para></listitem>
+
 <listitem><para>
 Ttys and ptys are handled as securable objects using file-like permissions
 and owner/group information.  <command>chmod</command> and
diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml
index 7e5376889..2d0396271 100644
--- a/winsup/doc/pathnames.sgml
+++ b/winsup/doc/pathnames.sgml
@@ -80,6 +80,15 @@ posix=[0|1].  The meaning of the options is as follows.</para>
 	      otherwise.
   auto      - Ignored.
   binary    - Files default to binary mode (default).
+  bind      - Allows to remount part of the file hierarchy somewhere else.
+              In contrast to other entries, the first field in the fstab
+	      line specifies an absolute POSIX path.  This path is remounted
+	      to the POSIX path specified as the second path.  The conversion
+	      to a Win32 path is done on the fly.  Only the root path and
+	      paths preceding the bind entry in the fstab file are used to
+	      convert the POSIX path in the first field to an absolute Win32
+	      path.  Note that symlinks are ignored while performing this path
+	      conversion.
   cygexec   - Treat all files below mount point as cygwin executables.
   dos       - Always convert leading spaces and trailing dots and spaces to
 	      characters in the UNICODE private use area.  This allows to use
@@ -186,6 +195,15 @@ mount the root dir with special options (for instance, as text mount).</para>
   <para>Set the cygdrive prefix to /mnt:</para>
   <screen>none /mnt cygdrive binary 0 0</screen>
 </listitem>
+<listitem>
+  <para>Remount /var to /usr/var:</para>
+  <screen>/var /usr/var none bind</screen>
+  <para>Assuming <filename>/var</filename> points to
+  <filename>C:/cygwin/var</filename>, <filename>/usr/var</filename> now
+  also points to <filename>C:/cygwin/var</filename>.  This is equivalent
+  to the Linux <literal>bind</literal> option available since
+  Linux 2.4.0.</para>
+</listitem>
 </itemizedlist>
 
 <para>Whenever Cygwin generates a Win32 path from a POSIX one, it uses