<Chapter Label=
"Installation">
<Heading>Installation</Heading>
<Index>Installation</Index>
<!-- @Installation -->
<!-- %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -->
<Section Label=
"Installing this package">
<Heading>Installing this package</Heading>
The &Polenta; package is part of the standard distribution of &GAP; and
so normally there should be no need to install it separately.
If by any chance it is not part of your &GAP; distribution, then
the standard method is to unpack the package into the <C>pkg</C>
directory of your &GAP; distribution. This will create a <C>polenta</C>
subdirectory.
For other non-standard options please see
Chapter <Ref Chap=
"Installing a GAP Package" BookName=
"Reference"/>
of the &GAP; Reference Manual.
<P/>
Note that the GAP-Packages <Package>Alnuth</Package> and <Package>Polycyclic</Package>
are needed for this package.
Normally they should be contained in your distribution. If not,
they can be obtained at <
URL>
https://www.gap-system.org/Packages/packages.html</
URL>.
<!-- %To create the documentation, go into the <C>doc</C> directory and type -->
<!-- %<C>make_doc</C>. -->
</Section>
<!-- %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -->
<Section Label=
"Loading the Polenta package">
<Heading>Loading the &Polenta; package</Heading>
<Index>Loading the &Polenta; package</Index>
If the &Polenta; package is not already loaded
then you have to request it explicitly.
This can be done via the <Ref Func=
"LoadPackage" BookName=
"Reference"/> command.
</Section>
<!-- %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -->
<Section Label=
"Running the test suite">
<Heading>Running the test suite</Heading>
Once the package is installed, it is possible to check the correct
installation by running the test suite of the package.
<Example><![
CDATA[
gap> ReadPackage(
"Polenta",
"tst/testall.g" );
]]></Example>
For more details on Test Files see
Section <Ref Sect=
"Test Files" BookName=
"Reference"/> of the
&GAP; Reference Manual.
<P/>
If the test suite runs into an error, even though the packages
Polycyclic and Alnuth and their depdendencies
have been correctly installed, then please send a message
to <C>mhorn@rptu.de</C> including the error message.
</Section>
</Chapter>