The GAP Library of Tables of Marks
==================================

Description
-----------

This is Version 1.2.1 of the GAP Library of Tables of Marks,
which is an add-on package for GAP 4.

If you have found important features missing or if there is a bug,
let us know and we will try to address it in the next version of the
GAP Library of Tables of Marks.
Please send a short email to

          Liam Naughton    <liam.naughton@nuigalway.ie>

This holds in particular if you have used the GAP Library of Tables of Marks
to solve a problem.

You can also reach the GAP developers by sending an email to the general
GAP email address for problems with GAP:

                     gap-trouble@dcs.st-and.ac.uk


Contents
--------

With this version you should have obtained this README file
and an archive file containing the GAP interface and the data files,
in the following files and directories:

        data            the directory with the data files
        doc             the directory containing the manaul for the pacakage
			as well as the list of changes since the release of 
			version 1.0 (with GAP 4.3), in TeX format
        gap             the directory with the GAP code
        htm             the directory with the list of changes
                        since the release of version 1.0 (with GAP 4.3),
                        in HTML format
        init.g          the file that reads the declaration part of the package
        read.g          the file that reads the implementation part of the package
	PackageInfo.g   the file for the new package loading mechanism
        tst             the directory with some test files


Unpacking
---------

You may have got the GAP Library of Tables of Marks as
a zoo archive (filename ends with .zoo)
or a compressed tar archive (filename ends with .tar.gz).
In each case, use the appropriate command on your system to unpack
the archive.

On UNIX systems the zoo archive may be unpacked by

    zoo x tomlib1r2p1.zoo

which will unpack the archive into a directory `tomlib' in the
current directory. 

On UNIX systems the compressed tar archive may be unpacked by

    tar xzf tomlib1r2p1.tar.gz

or, if tar on your system does not understand the option z, by

    gunzip tomlib1r2p1.tar.gz
    tar xf tomlib1r2p1.tar

which will in each case unpack the code into a directory `tomlib'
in the current directory.

If your system does not have a zoo programme, you can pick up the
C-code for unzoo from the GAP web page and compile it on your system.
For this your system needs to have a C-compiler.
unzoo can be used to unpack the zoo archive, as follows:

    unzoo -x tomlib1r2p1.zoo

unpacks the archive into a directory `tomlib' in the current directory.


Installation
------------

Installation of the GAP Library of Tables of Marks means unpacking the
archive file in an appropriate directory.

For the two ways of installing GAP 4 packages in general,
see the sections "Installing a GAP Package" and
"GAP Root Directory" in the GAP 4 Reference Manual.

Once you have successfully installed the GAP Library of Tables of Marks,
it is usually loaded automatically when GAP is started;
if not then it can be loaded explicitly by typing

gap> LoadPackage( "tomlib" );
true
gap>

at the GAP prompt.
Then the functions of the library are available in the current session.
