NOTE: ATLAS 3.4 has not yet been tried under Windows; any necessary changes
      will be released with the first patch.  This documentation is out of
      date (including the cygwin info), and will updated someday.


                               IMPORTANT:
Windows 95/98 does a remarkably poor job of process load balance.  If you change
the focus from the cygnus window, performance will immediately drop by
at least 1/3, and the timings will be inaccurate.  It is recommended that you
leave the focus on the install window throughout the entire install procedure.
This is not necessary for Windows NT/2K.

ATLAS requires unix-style make and /bin/sh commands in order to install on a
windows system.  A fairly complete unix-style environment is available free of
charge at the cygnus website,
   http://sourceware.cygnus.com/cygwin/

From this website, you can download the package, get installation instructions,
etc.  You will want to download the "full" version of cygwin, which includes
compilers, shells, make, etc.  If you need fortran, that must be downloaded
separately.

The installation is quite simple, involving downloading an executable and
installing with Windows' usual install procedure (you can remove it from
your machine with Windows' ADD/REMOVE if you later decide you don't want it).

Because people often miss them in the install instructions, I repeat two
very important pieces of information about the cygnus install here:

                              (1)
If, after installing cygnus, you get the message:
    Out of environment space
add the line
    shell=C:\command.com /e:4096 /p
to your c:\config.sys

                              (2)
After installation, ATLAS needs to find /bin/sh, so you should (assuming you
don't already have this directory made):
   mkdir -p /bin
Then, you should copy sh.exe from the cygwin bin directory to this one.
The location of the cygwin bin directory changes depending on where you
did the install, what type of machine you have, and the version of cygnus.
Here is an example:
    /cygnus/cygwin-b20/H-i586-cygwin32/bin
the cygwin-b20 is a version number, so you might see cygwin-b21, if you have
a newer release, for instance.  The i586 refers to your processor, you might
expect to see i386, i486, i586 or i686, for instance.

After this is done, simply follow the instructions given in README.INSTALL,
running all command in a cygnus window.  By default, ATLAS will be compiled
with the gnu gcc compiler that comes with cygnus.  Gnu gcc provides better
ATLAS performance than does MSVC++ (or Watcom C), so we recommend that you
leave gcc as the compiler.  The ATLAS library that is produced should be able
to be linked in using MSVC++, if that is your programming environment of choice.
