GRAPE (GRaph Algorithms using PErmutation groups),
Version 2.1, L.H.Soicher@qmw.ac.uk, 12 July 1993.

Note: all file paths in this document are relative to the main
directory for the GRAPE package.

To install GRAPE 2.1 (as a GAP Share Library Package), follow the
instructions in the Sections on GRAPE in the Chapter on Share Libraries
in the GAP Manual. This Chapter is included as part of the file
doc/grapedoc.dvi, or see doc/share.tex.  The main documentation on
GRAPE is in the Chapter Grape of the GAP manual, and this Chapter is
also included in doc/grapedoc.dvi, or see doc/grape.tex.

Changes from previous versions of GRAPE other than new functions and new 
function parameters:
   (1) Nauty Version 1.7 is now used. Note that canonical labellings could 
       be different from those produced by nauty 1.4, which was used in 
       previous versions of GRAPE.
   (2) EnumColadj now returns an intersection matrix for the trivial orbital
       graph, in addition to the intersection matrices for the other orbital
       graphs.
   (3) MakeIntransitiveGroupGenerators now called IntransitiveGroupGenerators.
   (4) VertexName now returns a copy (of the vertex name).
      
The functionality (although not necessarily the speed) of the functions
Enum and EnumColadj are now handled by the standard functions
OperationCosetsFpGroup in GAP, and OrbitalGraphIntersectionMatrices in
GRAPE. The functions Enum and Enumcoladj are not well supported, and
make use of fortran and pascal programs.  However, if a user requires
the Enum or EnumColadj functions and you have fortran and pascal
compilers, then cd to directory src, and type

    compileothers

Then the Enum and Enumcoladj commands will work for a single
architecture setup (for multiple architectures you will have to do
something analogous to that described in the GAP Manual for setting up
nauty under GRAPE).  Also, for using Enum, EnumColadj, and the related
standalones enum3 and enum3ca, the user must have an environment
variable  GRAPE_BIN  set to the value of the bin directory of the GRAPE
package. Also, s/he must be aware that the use of these functions or
standalones causes temporary files with names starting with GRAPE_ to
be created and deleted in the current directory, and so if s/he uses
these programs then two should not be run at the same time in the same
directory.

GRAPE is provided "as is", with no warranty whatsoever. Please read the
copyright notice in the file COPYING.

Please send comments on GRAPE, bug reports, etc. to L.H.Soicher@qmw.ac.uk.  
