How to install LinBox (for developers using cvs)


See also HACKING.  Once the LinBox module has been checked out using cvs,

1. Make sure the bin of autoconf, automake and libtool are in your path. Depending on your system installation (see HACKING), you may also need to set the environment variable ACLOCAL_FLAGS to "-I <automake, libtool prefix>/share/aclocal".

2. Go to the newly-created linbox directory and run the script autogen.sh, optionally you may specify the LinBox installation directory or an optional package directory using prefixes:
> cd linbox
> ./autogen.sh [--prefix=<inst. dir.> --with-package=<location> --enable-feature]
Gmp is required and its location must be specified <gmp location> is not a standard location such as /usr or /usr/local:
> ./autogen.sh --with-gmp= <gmp location> [...]
Atlas, or other source of BLAS, is also required and its location must be specified if not standard.
> ./autogen.sh --with-atlas= <atlas location> [...]
This sets up the library and runs  ./configure

3. Optional configurations

3.1. Where to put the include/ and lib/ directories:
--prefix= <chosen installation directory>
Ex:  --prefix= `pwd` will put the files within the current directory

3.2. The use of an optional package is switched on by specifying the directory where it can be found:

--with-package=<package_directory>

<package_directory> can be left blank if the package is installed in a standard directory (/usr or /usr/local)
Ex: --with-givaro will enable the use of Givaro library and assume it is installed in a standard directory

Available packages are the following:

Givaro --with-givaro= <givaro_directory> used for finite field arithmetic.
Lidia --with-lidia= <lidia_directory> used for finite field arithmetic.
NTL --with-ntl= <ntl_directory> used for finite field, polynomial arithmetic.
Saclib --with-saclib= <saclib_directory> not yet used
Maple --with-maple= <maple-directory>  used to create an interface with Maple.
Doxygen --with-doxygen= <doxygen-path>  used to create the html reference manual.

Note:

the use of --with-default= <default_directory> can add a special directory to the default location of library

the use of --with-all specifies that all package will be used

3.3. The use of special feature is switched on by calling the enable parameter:

--enable-feature
Ex: --enable-shared will turn on the build of shared library

Available extra features are the following:

--enable-optimization turn on runtime optimization during the configuration
--enable-doc turn on the build of documentation via Doxygen.
4.  Install the library:
>  make install

Copyright 1999-2005 The Linbox Group.