> < ^ Date: Fri, 16 Jun 1995 08:30:00 +0100 (WET)
> < ^ From: Martin Schoenert <martin.schoenert@math.rwth-aachen.de >
^ Subject: Installation of GUAVA contributed package

Several people have pointed out that there is no installation instruction
for the GUAVA package.

The GUAVA package consists of a lot of GAP code and three C programs (by
J. Leon) that are used to compute automorphism groups of binary codes and
test isomorphism of binary codes.

Note that GAP *cannot* use those programs under DOS, so you cannot
compute automorphism groups of binary codes or test for isomorphism of
binary codes under DOS.

The GAP code needs no further installation. You need only say
'RequirePackage( "guava" );' in a GAP session before using GUAVA.

To install the C programs go to 'gap3r4p2/pkg/guava/' and say 'make'.
If you don't want to use the GNU C compiler, say 'make CC=cc CFLAGS=-O'.

This will compile the programs and place the object files and the
executable programs in subdirectory 'bin/<hostname>/', where <hostname>
is the name of the computer on which you compiled the programs
(e.g. in 'bin/bert/' if you compile on a machine called 'bert').

If you want to use GUAVA on several different machines with the same
architecture (e.g. 'bert' and 'tiffy'), just compile on one such machine
(e.g. 'bert'), and make symbolic links for the other machines (e.g.
'ln -s bin/bert bin/tiffy').

If you want to use GUAVA on several different machines with different
architectures, just compile on each such machine.

There is a minor bug in GUAVA. One cannot compute the automorphism group
of a code whose underlying vectorspace has dimension 1. For example

C := GeneratorMatCode( [ [ 1 ] ], "example", GF(2) );
AutomorphismGroup( C );

results in an error.


-- .- .-. - .. -.  .-.. --- ...- . ...  .- -. -. .. -.- .-
Martin Sch"onert,   Martin.Schoenert@Math.RWTH-Aachen.DE,   +49 241 804551
Lehrstuhl D f"ur Mathematik, Templergraben 64, RWTH, 52056 Aachen, Germany

> < [top]