***************************** FILE DESCRIPTIONS *******************************
The files in this archive are:

Make.<ARCH>           : The Make include file used to build these libs
SUMMARY.LOG           : The SUMMARY.LOG created by atlas_install.  Provides
                        further information about the installation machine.
cblas.h               : The C header file for the C interface to the BLAS.
liblapack.a           : The LAPACK routines provided by ATLAS.  If you want a
                        full lapack library, the .o in this lib can be archived
                        into the f77 lapack lib without error.  This interface
                        is for CVF with /iface:cdecl /iface=nomixed_str_len_arg.
liblapack_structval.a : Same as above, but with CVF interface set to
                        /iface:cdecl only.
libcblas.a            : The ANSI C interface to the BLAS.
libf77blas.a          : The Fortran77 interface to the BLAS.  This interface
                        is for CVF with 
                        /iface:cdecl /iface=nomixed_str_len_arg.
libf77blas_structval.a: Same as above, but with CVF interface set to
                        /iface:cdecl only.
libatlas.a            : The main ATLAS library, providing low-level routines
                        for all interface libs.

********************************* LINKING *************************************
When linking, remember that order is important.  So, if you want uniprocessor
libs, your link line would contain IN THIS ORDER:
   -LTHIS_DIR -llapack -lcblas -lf77blas -latlas 

************************** GETTING A FULL LAPACK LIB **************************
ATLAS does not provide a full lapack library.  However, there is a simple way
to get ATLAS to provide its faster LAPACK routines to a full LAPACK library.
ATLAS's internal routines are distinct from LAPACK's, so it is safe to compile
ATLAS's LAPACK routines directly into a netlib-style LAPACK library.
First, obtain the LAPACK src from netlib and build the LAPACK library as
normal.  Then, in this directory (where you should have a liblapack.a),
issue the following commands:
  mkdir tmp
  cd tmp
  ar x ../liblapack.a
  cp <your LAPACK path & lib> ../liblapack.a
  ar r ../liblapack.a *.o
  cd ..
  rm -rf tmp

Just linking in ATLAS's liblapack.a first will not get you the best LAPACK
performance, mainly because LAPACK's untuned ILAENV will be used instead
of ATLAS's tuned one.
