[patch] cygdrive and user/system documentation clarification

[Brian Dessent <brian at dessent dot net>]

Corinna Vinschen wrote:

> Looks good to me.  However, please send patches to cygwin-patches and
> add a ChangeLog entry.

As requested.  I include two patches and two ChangeLog entries since the
two files are in different directories.  Is that the preferred way?

utils/
2005-04-20  Brian Dessent  <brian@dessent.net>

	* utils.sgml (mount): Clarify setting cygdrive prefix for user
	and system-wide.

doc/
2005-04-20  Brian Dessent  <brian@dessent.net>

	* pathnames.sgml (mount-table): Indicate that user-specific
	mounts override system-wide.

Index: utils.sgml
===================================================================
RCS file: /cvs/src/src/winsup/utils/utils.sgml,v
retrieving revision 1.51
diff -u -r1.51 utils.sgml
--- utils.sgml	24 Feb 2005 04:32:45 -0000	1.51
+++ utils.sgml	20 Apr 2005 11:20:15 -0000
@@ -729,9 +729,11 @@
 </screen>
 </example>
 
-<para>Note that if you set a new prefix in this manner, you can
-specify the <literal>-s</literal> flag to make this the system-wide default 
-prefix.  By default, the cygdrive-prefix applies only to the system-wide setting.  
+<para>Note that the cygdrive prefix can be set both per-user and system-wide, 
+and that as with all mounts, a user-specific mount takes precedence over the 
+system-wide setting.  The <command>mount</command> utility creates system-wide 
+mounts by default if you do not specify a type.  Use the <literal>-s</literal> 
+or <literal>-u</literal> flag to indicate a system or user mount, respectively.
 You can always see the user and system cygdrive prefixes with the 
 <literal>-p</literal> option.  Using the <literal>-b</literal>
 flag with <literal>--change-cygdrive-prefix</literal> makes all new 

Index: pathnames.sgml
===================================================================
RCS file: /cvs/src/src/winsup/doc/pathnames.sgml,v
retrieving revision 1.18
diff -u -r1.18 pathnames.sgml
--- pathnames.sgml	6 Mar 2005 02:46:54 -0000	1.18
+++ pathnames.sgml	20 Apr 2005 11:25:41 -0000
@@ -47,7 +47,9 @@
 where &lt;version&gt; is the latest registry version associated with
 the Cygwin library (this version is not the same as the release
 number).  The system-wide table is located under the same subkeys
-under HKEY_LOCAL_SYSTEM.</para>
+under HKEY_LOCAL_SYSTEM.  The user mount table takes precedence over 
+the system-wide table if a path is mounted in both.  This includes the
+setting of the cygdrive prefix.</para>
 
 <para>Since Windows uses drive letters instead of a single filesystem
 root, the POSIX root <filename>/</filename> must be set to a directory