	Installation hints for CONGEN

The directory structure of CONGEN is designed to handle multiple architectures.
This is done by having multiple copies of the sources, binaries, and libraries
rooted under the $CGROOT directory. The script, $CGROOT/setcgplatform,
attempts to determine the correct platform name, and is used to set the
environment variables to the correct directory tree. The current platforms
are named:

sgi...		Silicon graphics. The encoding is described below.
linux		PC's running 32 bit Linux
linux_x86_64	PC's running 64 bit Linux
unicos		Cray running Unicos
convex		Older Convex machines
sparc		Sun workstation
hpux		HP workstation running HPUX
alphaosf	DEC alpha running OSF
fujitsu		Fujitsu VP240

The key script in using CONGEN is the file, $CGROOT/cgdefs. It is
designed for our environment at Bristol-Myers Squibb where CONGEN
resides on two machines, horta and sherlock, and in different
directories on each. In a simple environment where CONGEN resides on
one machine, then just set the internal variable cgrootdir to
that directory and set cgrootdefined to 1, and comment out the first
if block in cgdefs.

The machine designation for the SGI machines is much more complicated
because of the variation in compilers and architectures. There are
five parts to the encoding: chip, operating system, compiler version, MIPS
architecture, and applications binary interface (ABI). The encoding
is sgi_r<chip>_i<O.S>_c<compiler>_m<architecture>_a<abi>. The choices are
as follows:

chip:	3k, 4k, 5k, 8k, 10k

irix:	5.3, 6.1, 6.2, 6.3, 6.4

compiler: 5.3, 6.1, 6.2, 7.0, 7.1, 7.2

MIPS:	1, 2, 3, 4, 5

abi	32, n32, 64

For the SGI's, the script, $CGROOT/cgdefs, attempts to match the current
machine with the available directories, and the variable CGPLATFORM
is set accordingly. The matching process is done by the Perl script, matchdir,
and attempts to find a CONGEN directory that is backward compatible with
your machine. You can force the selection of CGPLATFORM by setting
this environment variable prior to the execution of cgdefs. The most
compatible version of CONGEN is stored in the directory,
sgi_r3k_i5.3_c5.3_m1_a32.

Note, you will need to use flex-2.5.4 and bison-1.25 for building the
system. Both are available from ftp://prep.ai.mit.edu/pub/gnu/.
