=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
C MeatAxe Release 2.0.12           README              04-Nov-94
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

This is the C MeatAxe, a set of Programs for computing with
modular representations.

=================================================================
Changes from previous releases
=================================================================

2.0.12: Now compiles with old (non-ANSI) compilers (Thanks to
        Gene Cooperman). Updated the test script to reflect
	changes in chop.c (Thanks to Tom McDonough).
2.0.11: Fixed a bug in HP/UX 9.0 (sscanf() broken? -- see args.c)
2.0.10: Fixed a bug in matorder(). Thanks to Steve Linton.
2.0.9:  Added 'mwXXXid' to zsm (make identity matrix).
2.0.8:  Modified the word generator to work better with many
	generators.
2.0.7:  Increased the limit on the number of generators (now 50).
2.0.6:  Fixed an alignment problem in the bit string data type. 

=================================================================
AUTHORS AND COPYRIGHT
=================================================================

Most of the programs in this package are a re-write of Richard
Parker's FORTRAN programs. The C programs were written by Michael
Ringe with many contributions by Klaus Lux and Juergen Mueller.
The original version of the ZZZ module was written by Klaus Lux,
and the maketab program was developped by Marco van Meegen.

The MeatAxe is free software. You may use, copy and distribute it
freely under the terms of the GNU Genral Public Licence. See the
file COPYING for details.

Reports on bugs and suggestions for improvements are appreciated.
Please mail to

Michael Ringe
Lehrstuhl D fuer Mathematik
RWTH Aachen
5100 Aachen, Germany

E-mail: mringe@tiffy.math.rwth-aachen.de



=================================================================
FILES IN THE PACKAGE
=================================================================

Directory	Contents
----------	--------------------------------------------
src/		All C source (.c) and header (.h) files
bin/		Executable programs. This directory is empty
		in the distribution, except for the Makefile.
bin/proggy/	Some shell scripts to simplify the use of
		the MeatAxe programs.
lib/		The library directory, containing some group
		generators in text form (*.1, *.2) and ZEV
		input files (polyXX, cyclo).
doc/		Documentation in LaTeX form.
tests/		Files for testing the programs (see below).



=================================================================
HOW TO INSTALL THE C MEAT-AXE ON A UNIX MACHINE
=================================================================

1) Change to the `bin' directory and edit the Makefile. (See the
   instructions at the top of the Makefile)

2) Run

	make

   to compile all programs. If your make has problems with
   the Makefile, use gmake (GNU Make).

3) Modify your .profile (Bourne shell) or .cshrc (C shell)
   to include `bin' and `bin/proggy' in your PATH.

4) Change to the `tests' directory and run

	./testmtx

   This script should run without any error. It tests various
   programs using GF(2), GF(5), GF(25), and GF(256). You may
   also test the lattice package separately by typing

	./testmtx lattice

   This should produce a file named `m11.out'. Compare it
   with `m11.out.cmp' --- both files should be identical.

5) Further information concerning installation may be found
   in the documentation. To print the manual, change to the
   `doc' directory, run the file `meataxe.tex' through LaTeX
   and print it.
   
   Note: There are various .tex files in the `doc' directory.
   They are all included if you print `meataxe.tex'.


