--- 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 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 (). 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: . 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 -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 . 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 ), then you may send +mail to . This is a general, public forum for all +Cygwin users. +