This is the mail archive of the
cygwin-patches@cygwin.com
mailing list for the Cygwin project.
[patch] cygdrive and user/system documentation clarification
- From: Brian Dessent <brian at dessent dot net>
- To: cygwin-patches at cygwin dot com
- Date: Wed, 20 Apr 2005 04:29:15 -0700
- Subject: [patch] cygdrive and user/system documentation clarification
- Organization: My own little world...
- References: <BAY10-F31320CAABACB6330AD865EE9290@phx.gbl> <426449CF.CD24BEB8@dessent.net> <wkd5sq1tgn.fsf@mx0.connact.com> <20050419193940.GF26832@trixie.casa.cgf.cx> <wkmzruzcbv.fsf@mx0.connact.com> <4265F5D6.2458C631@dessent.net> <20050420104114.GX16098@cygbert.vinschen.de>
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 <version> 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