Apr 15 2000  DJ Delorie  dj@redhat.com

This is the README for the Cygwin download area.

* What is Cygwin?

See http://sourceware.cygnus.com/cygwin/

* How do I install cygwin?

The easiest way is to download the setup.exe program from
ftp://sourceware.cygnus.com/cygwin/latest/setup.exe .  This program
will download everything from the "latest" directory and install it
on your system.  You can also direct the program to install only the
.tar.gz files that are found in your current directory.

WARNING: If you are upgrading from an old version of cygwin, unmount
all your old mount points and back up your old installation before
upgrading.  YOUR OLD MOUNTS WILL BE OVERWRITTEN if you do not do this.

Note that setup.exe is a work in progress.  It does not go to any effort
to preserve your existing setup and could overwrite things that you don't
want overwritten unless you're careful.  It will reset your root directory
to point to whatever directory you choose for installation.

* I'd rather do it myself.

If you are more adventurous, or would like slightly more control, you can
download everything by hand and extract only the files that you need.

Get the files that end in .tar.gz and don't end in -src.tar.gz.  Pick the
ones with the highest version number.  Use "tar xvfz <whatever>.tar.gz"
to install (untar) them.

Note: to develop software, you'll need *at least* gcc, binutils, and
cygwin.  You'll probably end up needing gdb, make, and a few others
(like ash and *utils) if you're porting existing software.

Untar everything from your chosen "cygwin root" directory.

* But I don't have a tar program!

Get bootstrap.zip instead.  Choose a directory to be your "cygwin root"
directory, and unzip it there.  It should create a "tmpbin" directory
with three files in it.  One of them is tar (you need the others also,
of course).  Just run it right from that directory (or move it to
some other random directory, but NOT to your system32 directory) like
"tmpbin\tar xvfz <whatever>.tar.gz".

* How do I build from source?

You need the <whatever>-src.tar.gz files.  Some packages require
other packages (cygwin/*-src.tar.gz is a common requirement, as is
common/*-src.tar.gz).

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
sources.  Check out the cygwin web site for more details.

* Where do I get help?

http://sourceware.cygnus.com/cygwin/ has docs, or send email to
cygwin@sourceware.cygnus.com (which is a general-purpose public discussion
forum for cygwin users).
