
********************************* CONFIG **************************************
If your "make config" fails, you probably need to point config at your 
ANSI C compiler.  Simply type:
  make config CC=<ANSI C Compiler>
If you need to throw a flag to cause your compiler to assume ANSI C, include
this as well.  For instance, on old HP systems I would:
   make config CC="cc -Aa"

******************************** INSTALL **************************************
Most problems occur during installation.  If you have built the library as
recommended in README.install, a complete log of the installation process
will have been kept in ATLAS/bin/<arch>/INSTALL_LOG (note that <arch> will
be replaced by the architecture name you selected during install, for instance
Linux_PII).  If an error occurred which prevented installation from completing,
this directory should contain a file ERROR.LOG, which provides some
information, and perhaps points to another log file where more details are
available.  Typical problems would be invalid compilers, compile flags, out of
disk space, etc.

The user should examine the indicated log files for error messages.  If install
does not point the user at a specific log file, do an ls -l, and examine
the newest file aside from ERROR.LOG & SUMMARY.LOG.

Under Unix, you may want to do
   fgrep -i error *
in your INSTALL_LOG directory to ensure there were no install errors.

If you are able to correct the problem (or it was a one-time thing, for instance
filesystem problems), simply repeat your 
   make install arch=<arch>
and the ATLAS install will continue where it left off before.  If you wish
to restart the install from scratch, the easiest method is to do a 
   make killall arch=<arch>
followed by the above install (and possibly configure) command.

If you are unable to diagnose the problem from these hints, the user should
check the ATLAS errata file at 
   http://www.cs.utk.edu/~rwhaley/ATLAS/errata.html
This file contains info about any known bugs and their fixes, compiler errors
that effect ATLAS, etc.

If the problem is inadequate performance, the file 
   ATLAS/bin/<arch>/INSTALL_LOG/SUMMARY.LOG
should be examined in detail.  Make sure that ATLAS detected the correct
level 1 cache size, number of registers, etc. 

If after these steps you are unable to fix the problem, you can send mail to 
   atlas@cs.utk.edu

Include a thorough description of your system, what problem you are
encountering, what you were doing when it happened, etc.  All questions and
bug reports should minimally include the Make.<arch> file you were using, and
the contents of your INSTALL_LOG directory.  One way to easily package these
files together is shar (although tar, or any other method is OK).  For instance
from your ATLAS directory, you might
    shar bin/<arch>INSTALL_LOG/* Make.<arch> > error.sh
and then attach error.sh to your mail to atlas@cs.utk.edu.

******************************  LINKING  **************************************
If you have missing symbols on link make sure you are linking in all of the
libraries you need.  For instance, a code calling the Fortran77 interface
to the BLAS would need:
   -L$(MY_HOME)/ATLAS/lib/$(MY_ARCH)/ -lf77blas -latlas

The full LAPACK library created by merging ATLAS and netlib LAPACK requires
both C and Fortran77 interfaces, and thus that link line would be:
   -L$(MY_HOME)/ATLAS/lib/$(MY_ARCH)/ -llapack -lf77blas -lcblas -latlas
