OK to update release/README ?

Sun Jul 27 11:08:00 GMT 2003

With the attached (patch)?

Elfyn

-- 
Elfyn McBratney, EMCB  |  http://www.nongnu.org/wwwauth/
http://www.emcb.co.uk  |  http://www.emcb.co.uk/webauth/
elfyn@emcb.co.uk       |  wwwauth-users AT nongnu DOT org
-------------- next part --------------

--- README.release.orig	2003-07-27 11:57:01.000000000 +0100
+++ README.release	2003-07-27 11:56:20.000000000 +0100
@@ -1,5 +1,6 @@
 Apr 15 2000  DJ Delorie  dj@redhat.com
 Revised Aug 23 2000 David Starks-Browning starksb@ebi.ac.uk
+Revised Jul 27 2003 Elfyn McBratney elfyn@emcb.co.uk
 
 This is the README for the Cygwin download area.
 
@@ -12,11 +13,13 @@ See http://cygwin.com/ .
 Download <http://cygwin.com/setup.exe> and run it.  Or run it directly
 from your browser.  This will then download the list of available
 packages, and offer to install them for you.  There are a number of
-options within setup to control installation details.
+options within setup to control installation details.  For more
+information on using setup.exe, see "Setting up Cygwin" in the Cygwin
+User's Guide (<http://www.cygwin.com/cygwin-ug-net/setup-net.html>).
 
 Using setup.exe is the supported way to install Cygwin.  If you know what
 you're doing, you *could* download things "by hand", however.  For some
-info on this check out:  http://cygwin.com/download.html .  Please don't
+info on this check out:  <http://cygwin.com/download.html>.  Please don't
 bother the cygwin mailing list with questions about doing things the hard
 way.  If you need to ask questions, you probably should be using setup.exe.
 
@@ -35,14 +38,15 @@ way.  If you need to ask questions, you 
     been reports that NAI anti-virus products will "hang" when
     processing Cygwin .tar.bz2 archives.
 
-  - Make sure you have enough disk space.  A new, full Cygwin
-    installation will use about 75MB of disk space in the "root"
+  - Make sure you have enough disk space.  A new, full, complete Cygwin
+    installation will use about 500MB of disk space in the "root"
     directory.  Setup will keep copies of the .tar.bz2 files it uses in
-    the directory where you ran it, in subfolders 'latest' and
-    'contrib'.  This could be as much as about 30MB.  (If you are an
-    NT Domain User with a Roaming Profile, you may need to take care
-    that setup doesn't store these on your Desktop.)  If you get the
-    -src.tar.bz2 archives also, that's another 75MB or so.
+    the directory where you ran it, in a subdirectory 'release', under
+    a URI-mangled name, derived from the mirror hostname.  This could be
+    as much as ~300MB.  (If you are an NT Domain User with a Roaming
+    Profile, you may need to take care that setup doesn't store these on
+    your Desktop.)  If you get the -src.tar.bz2 archives also, that's
+    another ~500MB or so.
 
 * What configuration options does setup allow?
 
@@ -52,33 +56,40 @@ You can:
 	- Install from Current Directory
 
 When installing, you will have to specify:
-	- install root directory (default is C:\cygwin)
+	- Install Root Directory (default is C:\cygwin)
 	- Default Text File Type ("DOS" or "Unix")
-	- Install For ("All" or "Just Me")
+	- Install For ("All Users" or "Just Me")
 
 Choose "DOS" if you want text files to have \r\n line endings (like
 NOTEPAD.EXE requires), or "Unix" for \n line endings.
 
-Choose "All" if you want the Cygwin mount table to be available to
+Choose "All Users" if you want the Cygwin mount table to be available to
 anyone who logs into the machine.  (Recorded in the registry under
 HKEY_LOCAL_MACHINE.  May require Administrative privileges on Windows
 NT.)  Choose "Just Me" otherwise.  (Recorded in the registry under
-HKEY_CURRENT_USER.)
+HKEY_CURRENT_USER.)  Note:  If you want to install services, that
+will run under LocalSystem, such as inetd or sshd, you MUST install
+for "All Users".
+
+Also note that the location of the mount table is subject to change, and
+that any manipulation of the mount table should be done via the Cygwin
+`mount' command. 
 
 Network proxy settings are currently taken from Internet Explorer 5.
 If you must get through a firewall or proxy server, and do not have
 IE5 installed and configured properly, you will probably have to
 download packages manually as described above.
 
-Note that setup.exe is a work in progress.  Expect features to be
-missing, or to change in the future.  For example, there is currently
-no uninstall option.
+Note that although setup.exe is powerful tool for installing Cygwin,
+it is still a work in progress.  Expect features to be missing, or
+to change in the future.  For example, there is currently no uninstall
+option.
 
 * How do I build from source?
 
 You need the <whatever>-src.tar.bz2 files.  Some packages require
-other packages (cygwin/*-src.tar.bz2 is a common requirement, as is
-common/*-src.tar.bz2).
+other packages (which should be stated in their Cygwin README under
+/usr/doc/Cygwin).
 
 If you are really serious about building from source you may want to
 set up CVS on your system so that you can use the latest development
@@ -96,6 +107,9 @@ Be sure to check the /usr/doc and /usr/d
 README files.  These will contain special instructions for specific
 packages, if relevant.
 
-After you've read the docs and the FAQ, and searched the mailing list
-archives, then you may send mail to <cygwin@cygwin.com>.  This
-is a general, public forum for all Cygwin users.
+After you've read the docs and the FAQ, clicked on all relavant links
+on the Cygwin home page, and searched the mailing list archives
+(available at <http://cygwin.com/ml/THELISTNAME/>), then you may send
+mail to <cygwin@cygwin.com>.  This is a general, public forum for all
+Cygwin users.
+
