Press on the cygwin "install now!" link on the http://www.cygwin.com/ home page.
	Select install from internet and choose the default options. If you are behind a firewall then enter its details
	ftp.funet.fi is a fast site from the list.
	NB: In the selection of packages, you must enter the "devel" directory and select "gcc"
	The rest of the options can remain as is.
	Run using Start -> Programs -> Cygwin -> Cygwin bash shell
	This runs a UNIX Bash Shell (emulated). Use the usual UNIX commands (Derek's Quick Unix Guide...) to get around the OS.

	Download this test file - hello.cpp and save somewhere easy to find.
	If it saves the file as "hello.cpp.txt" type "mv hello.cpp.txt hello.cpp"
	Compile using: C++ -o hello.exe hello.cpp
	Run by typing "./hello"
	You should get the output "Hello world!"

The Cygwin Project WWW Site

===========================



   The main WWW page for the Cygwin project is http://sourceware.cygnus.com/cygwin/.



   A page containing tool-specific information is http://www.cygnus.com/pubs/gnupro/



   Links to additional documentation are accessible from the main web page.



Installation Instructions

*************************



Contents

========



   The following packages are included in the full release:



   Development tools: binutils, bison, byacc, dejagnu, diff, expect,

flex, gas, gcc, gdb, itcl, ld, libstdc++, make, patch, tcl, tix, tk



   User tools: ash, bash, bzip2, diff, fileutils, findutils, gawk,

grep, gzip, m4, sed, shellutils, tar, textutils, time



   The user tools release only contains the user tools.



   Full source code is available for these tools.  It is split into

these two units.



Installing the binary release:

==============================



   Important!  Be sure to remove any older versions of the Cygwin tools

from your PATH environment variable so you do not execute them by

mistake.



   Connect to one of the ftp servers listed above and cd to the

directory containing the latest release.  On our primary server, that

would be:



   `ftp://go.cygnus.com/pub/sourceware.cygnus.com/cygwin/latest/'.



   If you want the development tools and the programs necessary to run

the GNU configure mechanism, you should download the full binary release

called `full.exe'.  If you only care about the user tools listed above,

download `user.exe' instead.



   If you have an unreliable connection, download the appropriate

binary in smaller chunks instead.  For the split cdk installer, get the

files in the `full-split' subdirectory.  Once downloaded, combine the

split files at the command prompt by doing a:



     copy /b xaa + xab + xac + ... + xak + xal full.exe

     del xa*.*



   A similar process can be used for the user tools.



   Once you have an install executable on your system, run it.  If a

previous version of the software is detected, it will offer to

uninstall it for you.



   Next it will ask you to choose an install location.  The default is

`:\cygnus\cygwin-b20'.  Feel free to choose another

location if you would prefer.



   Finally, it will ask you for the name of the Program Files folder

shortcut to add.  By default, the installer will create a `Cygwin B20'

entry in a folder called `Cygnus Solutions'.  When this step is

completed, it will install the tools and exit.



   At this point, you should be able to look under the start menu and

select "Cygwin B20".  This will pop up a bash shell with all special

environment variables set up for you.  If you are running Windows 95 or

98 and are faced with the error message "Out of environment space", you

need to increase the amount of environment space in your config.sys and

try again.  Adding the line `shell=C:\command.com /e:4096 /p' should do

the trick if `C:' is your system drive letter.



   There are two remaining thing you should do from this prompt.

First, you need to type `mkdir -p /tmp' to ensure that a directory for

temporary files exists for programs that expect to find one there.



   Second, if you are installing the full distribution (`full.exe'),

various programs will need to be able to find `/bin/sh'.  You should

`mkdir -p /bin' and put a copy of `sh.exe' there, removing the older

version, if present.  You can use the `mount' utility to select which

drive letter is mounted as `/'. See the Frequently Asked Questions

(FAQ) file for more information on `mount'.



   If you should ever want to uninstall the tools, you may do so via

the "Add/Remove Programs" control panel.