* new-features.sgml (ov-new1.7.6): Document "bind" option.

* pathnames.sgml (mount-table): Add "bind" option with example.

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.

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

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