How to use Crunchmake

This version of Crunch will not work on HP UX-systems. Major adaptations
are required. I may get round to writing an HP UX-version sometime in
the future but don't hold your breath.

The command file Crunchmake compiles the sources and installs the
executables. The files are provided in "tar" format, compressed using the
GNU gzip utility. The presence on your machine of gzip is therefore
required.  This version is written for Alpha Linux, SGI IRIX, IBM AIX
and Linux x86 machines. I am unfamiliar with Alpha systems running DEC
versions of Unix. However, I think the software will work.

In Crunchmake the value of the variable CC is set to cc, the usual name
of the C-compiler. If this is not correct make the appropriate change
there.

On SGI machines the  Fortran compiler provided is used. Its presence
is checked. 

On Linux x86 machines g77 is used, if it is available. Otherwise Red
Hat's fort77 is looked for. If this is not available either,
installation is halted.

On Alpha Linux machines Crunchmake checks for the presence of Compaq's
Fortran compiler and numerical libraries for Alpha Linux. Both are used
if available. If not, g77 is used again. On Alpha's Crunch runs about 3
times faster using Compaq's Fortran. For Linux x86 g77 works fine, I do
not know of any (commercially) available compilers that are
significantly better. 

Crunch uses Blas and Lapack routines for matrix and vector operations.
The routines used are distributed with the system in source form.
However, if at all possible, use versions precompiled and optimized for
your processor. In practice this means that, except for Alpha systems
where Crunchmake will use Compaq's library "cxml" automatically if its
presence is detected, you'll need to adapt Crunchmake to get the extra
performance which is available by using precompiled and optimized
routines. 

The file flags, which contains the library information, is built by
Crunchmake. The changes needed are indicated in the file, as well as
below. After changing Crunchmake just run the installation again, after
first removing the directory crunch_1.1 in its entirety. For Alpha Linux
systems the Compaq compiler and libraries may be downloaded from:

http://www.digital.com/fortran/linux/

Pentium optimized libraries compatible with g77 are available on the net too.

If you've read all this, copy Crunchmake and crunch.tar.gz to the
directory where you would like to have Crunch installed. Next, after changing
to this directory, type "chmod +x Crunchmake", followed by
"./Crunchmake".
Answer any questions appearing on your screen.


NOTE: On Alpha's, if you change over from g77 to Compaq's "fort"
compiler you must recompile all programs. The easiest way of doing
this is to install the Compaq compiler and libraries followed by
deleting the crunch_1.1 directory and installing Crunch again. Some of
the files used by Crunch are binary. Binary files written using
g77-compiled programs cannot be read by "fort"-compiled ones and vice
versa.

NOTE: The program search80.f in the source directory does not compile
correctly using Compaq's fort and any optimization. Use the flags used
in Crunchmake!

The include file "flags" created by Crunchmake is used building Deter
and Autofour. If you have on your machine Blas 1,2,3 routines and
Lapack, precompiled for your processor, go to line 210 in Crunchmake and
make the following changes:
1) change the value of $cxml to yes by inserting the line cxml="yes"
   before the if statement.
2) replace the reference to cxml ,i.e. -lcxml, with the appropriate
   references to your libraries. Use the -L option to specify the
   directory of the libraries if they are located in curious places such
   as not anywhere your ld program would look.