5. Installation of the Package

Installation of the package requires the GNU multiple precision library (GNU MP [xxx]). If this library is not available on your system, it has to be installed first. A copy of GNU MP can be obtained via anonymous ftp from many file servers around the world, for example: www.swox.com/gmp/. Installation of the ANU NQ is done in two steps. First the configure script is run:

 ./configure  

Among other things it will check whether it succeeds in locating the GNU MP library and the corresponding include files. If configure reports no problems, the next step is to start the compilation:

 make 

If the configure script told you that it could not find the GNU MP include files or the GNU MP libraries, you have to run make with additional parameters. For example, if you have installed GNU MP yourself in your home directory, you would type something like the following

 
  make GNU_MP_INC=/home/me/gmp-4.1.1 GNU_MP_LIB=/home/me/gmp-4.1.1/.libs
  

A compiled version of the program named `nq' is then placed into the directory `bin/<complicated name>'. The <complicated name> component encodes the operating system and the compiler used. This allows you to compile NQ on several architectures sharing the same files system.

If there are any warnings or even fatal error messages during the compilation process, please send a copy to the address at the end of this document together with information about your operating system, the compiler you used and any changes you might have made to the source code. I will have a look at your problems and try to fix them.

After the compilation is finished you can check if the ANU NQ is running properly on your system. Simply type

 make test 

The file runs some computations and compares their output with the output files in the directory `examples'. If testNq reports any errors, please follow the instruction that testNq prints out.

The installation is completed by compiling the manual of the package. This is done from within GAP.


gap> NqBuildManual();
Composing XML document . . .
Parsing XML document . . .
Checking XML structure . . .
LaTeX version and calling latex and pdflatex:
    writing LaTeX file, 3 x latex, bibtex and makeindex, 2 x pdflatex, dvips
Text version . . .
#I  first run, collecting cross references, index, toc, bib and so on . . .
#I  table of contents complete.
#I  producing the index . . .
#I  reading bibliography data files . . . 
#I  writing bibliography . . .
#I  second run through document . . .
Writing manual.six file . . .
And finally the HTML version . . .
#I  first run, collecting cross references, index, toc, bib and so on . . .
#I  table of contents complete.
#I  producing the index . . .
#I  reading bibliography data files . . . 
#I  writing bibliography . . .
#I  second run through document . . .
gap> ?NilpotentQuotient
Help: several entries match this topic - type ?2 to get match [2]

[1] ANU NQ: NilpotentQuotient
[2] ANU NQ: NilpotentQuotient
[3] Reference: NilpotentQuotientOfFpLieAlgebra
gap>
  



generated by GAPDoc2HTML