        The BLAD libraries (bibliothques lilloises d'algbre diffrentielle)
are a tower of C libraries designed to manipulate systems of differential
polynomials. It is sort of a C analogue of the MAPLE diffalg package.

        The BLAD project provides five libraries: ba0, bav, bap, bad, bai.

        It relies on the GNU MP library (GMP) library. Make sure GMP is
available on your computer. If it is not, see the GMP web pages at
http://swox.com/gmp/.

	If requested, it may also use the MPFR library. This library
can be downloaded from http://www.mpfr.org. If required, it may also
use the GSL library within some test files.

Building the libraries
----------------------

The BLAD project has an autoconf/automake/libtool based configuration system.
All the usual autoconf configure options are available.
Run ./configure --help for a summary.
To install the BLAD libraries you need to perform one of the following steps:

Basic build
-----------

Enter the following commands from the directory (usually blad) which
contains the source code:

./configure
make
make check (optional)
make dvi (optional)
make install

Alternative build
-----------------

You may build the library in another directory than the directory
which contains the source code. For this, enter the following commands
from the parent directory of blad:

mkdir blad-build
cd blad-build
../blad/configure
make
make check (optional)
make dvi (optional)
make install

Building example for a LINUX PC
-------------------------------

In this example, the GMP library is installed in /usr/local/gmp
and we want to install the BLAD libraries in /usr/local/blad-install.

./configure CFLAGS="-O2" --with-gmp="/usr/local/gmp" \
			 --prefix="/usr/local/blad-install" 

MPFR
----

There is some support for the MPFR library,

Provide the --enable--mpfr option to configure at build time in order
to get it used. The --with-mpfr=mpfr-directory facility is available.

GSL
---

Some test files make use of the GSL. 

Provide the --enable--gsl option to configure at build time in order
to get it used. The --with-gsl=gsl-directory facility is available.

COMPILING AND LINKING
---------------------

To compile and link a C program using BLAD, take care to the order of the 
libraries: 

  -lbai -lbad -lbap -lbav -lba0 [-lmpfr] -lgmp -lm

Alternatively, use the big library:

  -lblad [-lmpfr] -lgmp -lm

ANSI
----

The flag "-ansi" should not be passed since the libraries rely on signal
handling processing which are not ansi.

STRICT ALIASING
---------------

With some flags (such as -pedantic -Wall), the compiler complains about 
some data type aliasing performed in the libraries. To get rid of these 
warnings, try to provide the CFLAGS -Wno-strict-aliasing to the compiler.

RUNNING TESTS AND EXAMPLES USING GDB
------------------------------------

First you need to configure the library with CFLAGS="-g".
Then you need to use gdb together with libtool i.e. using command such as:

	libtool --mode=execute gdb <executable>
