[PATCH] docs/install.texinfo

["Pierre A. Humblet" <Pierre dot Humblet at ieee dot org>]

Joshua,

here is an upgrade to the FAQ.

Pierre


Index: install.texinfo
===================================================================
RCS file: /cvs/src/src/winsup/doc/install.texinfo,v
retrieving revision 1.44
diff -u -p -r1.44 install.texinfo
--- install.texinfo	21 Feb 2003 20:37:47 -0000	1.44
+++ install.texinfo	4 Mar 2003 00:25:03 -0000
@@ -194,14 +194,49 @@ character as a word delimiter.  Under ce
 possible to get around this with various shell quoting mechanisms, but
 you are much better off if you can avoid the problem entirely.
 
-In particular, the environment variables @samp{USER} and @samp{HOME} are
-set for you in /etc/profile.  By default these derive from your Windows
-logon name.  You may edit this file and set them explicitly to something
-without spaces.
-
-(If you use the @samp{login} package or anything else that reads
-/etc/passwd, you may need to make corresponding changes there.  See the
-README file for that package.)
+On Windows NT/2000/XP you have two choices:
+ at enumerate
+
+ at item You can rename the user in the Windows User Manager GUI and then
+run mkpasswd.
+
+ at item You can simply edit the /etc/passwd file and change the Cygwin user name 
+(first field). It's also a good idea to avoid spaces in the home directory.
+
+ at end enumerate
+
+On Windows 95/98/ME you can create a new user and run mkpasswd, 
+or you can delete the offending entry from /etc/passwd. 
+Cygwin will then use the name in the default entry with uid 500.
+
+ at subsection My @samp{HOME} environment variable is not what I want.
+
+When starting Cygwin from Windows, @samp{HOME} is determined as follows
+in order of decreasing priority:
+
+ at enumerate
+
+ at item @samp{HOME} from the Windows environment, translated to POSIX form.
+
+ at item The entry in /etc/passwd
+
+ at item @samp{HOMEDRIVE} and @samp{HOMEPATH} from the Windows environment
+
+ at item /
+
+ at end enumerate
+
+When using Cygwin from the network (telnet, ssh,...), @samp{HOME} is set 
+from /etc/passwd.
+
+If your @samp{HOME} is set to a value such as /cygdrive/c, it is likely 
+that it was set in Windows. Start a DOS Command Window and type 
+"set HOME" to verify if this is the case.
+
+Access to shared drives is often restricted when starting from the network,
+thus Domain users may wish to have a different @samp{HOME} in the 
+Windows environment (on shared drive) than in /etc/passwd (on local drive).
+Note that ssh only considers /etc/passwd, disregarding @samp{HOME}. 
 
 @subsection How do I uninstall individual packages?