* new-features.sgml: Add automounting of /, /usr/bin, and /usr/lib.

	* pathnames.sgml (pathnames-intro): Be more verbose about POSIX and
	Win32 paths.
	(mount-table): Add "auto" flag.  Add a paragraph about /usr/bin and
	/usr/lib.
	(pathnames-mount-ex): Enhance flags output.

3 files changed, 36 insertions, 9 deletions

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index dfa5e4d34..57aad4099 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,12 @@
+2009-05-14  Corinna Vinschen  <corinna@vinschen.de>
+
+	* new-features.sgml: Add automounting of /, /usr/bin, and /usr/lib.
+	* pathnames.sgml (pathnames-intro): Be more verbose about POSIX and
+	Win32 paths.
+	(mount-table): Add "auto" flag.  Add a paragraph about /usr/bin and
+	/usr/lib.
+	(pathnames-mount-ex): Enhance flags output.
+
 2009-05-13  Corinna Vinschen  <corinna@vinschen.de>
 	    Christopher Faylor  <me+cygwin@cgf.cx>
 
diff --git a/winsup/doc/new-features.sgml b/winsup/doc/new-features.sgml
index 3aee3963a..2c8107fb3 100644
--- a/winsup/doc/new-features.sgml
+++ b/winsup/doc/new-features.sgml
@@ -17,6 +17,10 @@
   are only local to the current session and disappear when the last
   Cygwin process in the session exits.
 
+- Cygwin creates the mount points for /, /usr/bin, and /usr/lib automatically
+  from it's own position on the disk.  They don't have to be specified in
+  /etc/fstab. 
+
 - If a filename cannot be represented in the current character set,
   the character will be converted to a sequence Ctrl-N + UTF-8 representation
   of the character.  This allows to access all files, even those not
diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml
index 86b537b7e..6234ee8f4 100644
--- a/winsup/doc/pathnames.sgml
+++ b/winsup/doc/pathnames.sgml
@@ -2,10 +2,15 @@
 
 <sect2 id="pathnames-intro"><title>Introduction</title>
 
-<para>Cygwin supports both Win32- and POSIX-style paths, where
-directory delimiters may be either forward or back slashes.  UNC
-pathnames (starting with two slashes and a network name) are also
-supported.</para>
+<para>Cygwin supports both Win32- and POSIX-style paths.  Directory
+delimiters may be either forward slashes or backslashes.  Paths using
+backslashes are always handled as Win32 paths.  POSIX paths must only
+use forward slashes as delimiter, otherwise they are treated as Win32
+paths and file access might fail in surprising ways.  Note that the
+usage of Win32 paths, though possible, is deprecated, since it
+circumvents important internal path handling mechanisms.  UNC pathnames
+(starting with two slashes and a network name) are also supported.
+</para>
 
 <para>POSIX operating systems (such as Linux) do not have the concept
 of drive letters.  Instead, all absolute paths begin with a
@@ -71,6 +76,7 @@ posix=[0|1].  The meaning of the options is as follows.</para>
               implement real POSIX permissions (default).  This flag only
 	      affects filesystems supporting ACLs (NTFS) and is ignored
 	      otherwise.
+  auto      - Ignored.
   binary    - Files default to binary mode (default).
   cygexec   - Treat all files below mount point as cygwin executables.
   exec      - Treat all files below mount point as executable.
@@ -117,6 +123,14 @@ doing.  In this case, use the <literal>override</literal> flag in the options
 field in the <filename>/etc/fstab</filename> file.  Since this is a dangerous
 thing to do, do so at your own risk.</para>
 
+<para><filename>/usr/bin</filename> and <filename>/usr/lib</filename> are
+by default also automatic mount points generated by the Cygwin DLL similar
+to the way the root directory is evaluated.  <filename>/usr/bin</filename>
+points to the directory the Cygwin DLL is installed in,
+<filename>/usr/lib</filename> is suppsoed to point to the
+<filename>/lib</filename> directory.  This choice is safe and usually
+shouldn't be changed.  An fstab entry for them is not required.</para>
+
 <para><literal>nouser</literal> mount points are not overridable by a later
 call to <command>mount</command>.
 Mount points given in <filename>/etc/fstab</filename> are by default
@@ -181,12 +195,12 @@ arguments:</para>
 <title>Displaying the current set of mount points</title>
 <screen>
 <prompt>bash$</prompt> <userinput>mount</userinput>
-f:/cygwin/bin on /usr/bin type system (binary)
-f:/cygwin/lib on /usr/lib type system (binary)
-f:/cygwin on / type system (binary)
+f:/cygwin/bin on /usr/bin type system (binary,auto)
+f:/cygwin/lib on /usr/lib type system (binary,auto)
+f:/cygwin on / type system (binary,auto)
 e:/src on /usr/src type system (binary)
-c: on /cygdrive/c type user (binary,noumount)
-e: on /cygdrive/e type user (binary,noumount)
+c: on /cygdrive/c type user (binary,posix=0,user,noumount,auto)
+e: on /cygdrive/e type user (binary,posix=0,user,noumount,auto)
 </screen>
 </example>