<html><head><title>[Example] 2 Installing and Loading the Example Package</title></head> <body text="#000000" bgcolor="#ffffff"> [<a href = "chapters.htm">Up</a>] [<a href ="CHAP001.htm">Previous</a>] [<a href ="CHAP00A.htm">Next</a>] [<a href = "theindex.htm">Index</a>] <h1>2 Installing and Loading the Example Package</h1><p> <P> <H3>Sections</H3> <oL> <li> <A HREF="CHAP002.htm#SECT001">Installing the Example Package</a> <li> <A HREF="CHAP002.htm#SECT002">Loading the Example Package</a> </ol><p> <p> <p> <h2><a name="SECT001">2.1 Installing the Example Package</a></h2> <p><p> To install the <font face="Gill Sans,Helvetica,Arial">Example</font> package, unpack the archive file, which should have a name of form <code>example-</code><var>XXX</var><code>.zoo</code> for some version number <var>XXX</var>, by typing <p> <code>unzoo -x example-</code><var>XXX</var><code></code> <p> in the <code>pkg</code> directory of your version of <font face="Gill Sans,Helvetica,Arial">GAP</font> 4, or in a directory named <code>pkg</code> (e.g. in your home directory). (The only essential difference with installing <font face="Gill Sans,Helvetica,Arial">Example</font> in a <code>pkg</code> directory different to the <font face="Gill Sans,Helvetica,Arial">GAP</font> 4 home directory is that one must start <font face="Gill Sans,Helvetica,Arial">GAP</font> with the <code>-l</code> switch, e.g. if your private <code>pkg</code> directory is a subdirectory of <code>mygap</code> in your home directory you might type: <p> <code>gap -l ";</code><var>myhomedir</var><code>/mygap"</code> <p> where <var>myhomedir</var> is the path to your home directory, which (since <font face="Gill Sans,Helvetica,Arial">GAP</font> 4.3) may be replaced by a tilde. The empty path before the semicolon is filled in by the default path of the <font face="Gill Sans,Helvetica,Arial">GAP</font> 4 home directory.) <p> After unpacking the archive, go to the newly created <code>example</code> directory and call <code>./configure </code><var>path</var><code></code> where <var>path</var> is the path to the <font face="Gill Sans,Helvetica,Arial">GAP</font> home directory. So for example if you install the package in the main <code>pkg</code> directory call <p> <pre> ./configure ../.. </pre> <p> This will fetch the architecture type for which <font face="Gill Sans,Helvetica,Arial">GAP</font> has been compiled last and create a <code>Makefile</code>. Now simply call <p> <pre> make </pre> <p> to compile the binary and to install it in the appropriate place. <p> <p> <h2><a name="SECT002">2.2 Loading the Example Package</a></h2> <p><p> To use the <font face="Gill Sans,Helvetica,Arial">Example</font> Package you have to request it explicitly. This is done by calling <p> <pre> gap> LoadPackage("example"); ---------------------------------------------------------------- Loading Example 2.0 by Werner Nickel (http://www.mathematik.tu-darmstadt.de/~nickel) Greg Gamble (http://www.math.rwth-aachen.de/~Greg.Gamble) For help, type: ?Example package ---------------------------------------------------------------- true </pre> <p> The <code>LoadPackage</code> command is described in Section <a href="../../../doc/htm/ref/CHAP075.htm#SSEC002.1">LoadPackage</a> in the <font face="Gill Sans,Helvetica,Arial">GAP</font> Reference Manual. <p> If <font face="Gill Sans,Helvetica,Arial">GAP</font> cannot find a working binary, the call to <code>LoadPackage</code> will still succeed but a warning is issued informing that the <code>HelloWorld()</code> function will be unavailable. <p> If you want to load the <font face="Gill Sans,Helvetica,Arial">Example</font> package by default, you can put the <code>LoadPackage</code> command into your <code>.gaprc</code> file (see Section <a href="../../../doc/htm/ref/CHAP003.htm#SECT004">The .gaprc file</a> in the <font face="Gill Sans,Helvetica,Arial">GAP</font> Reference Manual). <p> <p> [<a href = "chapters.htm">Up</a>] [<a href ="CHAP001.htm">Previous</a>] [<a href ="CHAP00A.htm">Next</a>] [<a href = "theindex.htm">Index</a>] <P> <address>Example manual<br>Januar 2006 </address></body></html>