5. Installation and auxiliary functions

5.1 Requirements

The ResClasses package needs at least GAP 4.4.6 and GAPDoc 0.999 [LN02]. It can be used under UNIX, under Windows and on the MacIntosh. ResClasses is completely written in the GAP language and does neither contain nor require external binaries.

5.2 Installation

Like any other GAP package, ResClasses must be installed in the pkg subdirectory of the GAP distribution. This is accomplished by extracting the distribution file in this directory. By default, the package ResClasses is autoloaded. If you have switched autoloading of packages off, you can load ResClasses via LoadPackage( "resclasses" );.

5.3 The testing routine

5.3-1 ResClassesTest
> ResClassesTest( )( function )

Returns: Nothing.

Performs tests of the ResClasses package. Errors, i.e. differences to the correct results of the test computations, are reported. The processed test files are in the directory pkg/resclasses/tst.

5.4 Changing the viewing format for residue class unions

5.4-1 ResidueClassUnionViewingFormat
> ResidueClassUnionViewingFormat( format )( function )

Returns: Nothing.

Switches between a longer and more descriptive (format = "long") and a shorter and less bulky (format = "short") viewing format for unions of residue classes. The former is the default and should be used when not many residue classes have to be displayed or residue classes of different rings are used, but the latter is usually preferable if it is always clear which the base ring is and if the printed representation of many residue classes should fit on one screen.



gap> ResidueClassUnionViewingFormat("short");
gap> ResidueClassUnion(Integers,12,[1,4,5,7,10,11]);
1(3) U 5(6)
gap> ResidueClassUnionViewingFormat("long");
gap> ResidueClassUnion(Integers,12,[1,4,5,7,10,11]);
Union of the residue classes 1(3) and 5(6) of Z


 

5.5 Building the manual

The following routine is a development tool. As all files it generates are included in the distribution file anyway, users will not need it.

5.5-1 ResClassesBuildManual
> ResClassesBuildManual( )( function )

Returns: Nothing.

This function builds the manual of the ResClasses package in the file formats LaTeX, DVI, Postscript, PDF, HTML and ASCII text. This is accomplished using the GAPDoc package by Frank Lübeck and Max Neunhöffer. Building the manual is possible only on UNIX systems and requires LaTeX, PDFLaTeX and dvips.




generated by GAPDoc2HTML