install

和itpp-3.10.0-rc1.tar.gz配合 的其它库程序

IT++ External Installation
**************************

IT++ External Requirements
==========================

IT++ External should compile without errors or warnings on most GNU/Linux
systems and on most other UNIX like systems like Solaris or Cygwin.
We assume that you have at least the following GNU software installed
on your computer:

  o GNU make, version 3.72.1 or later (to check version run `make
    --version')

  o GCC - GNU Compilers Collection (gcc, g++ and g77), version 3.3.x or
    later (to check version run `gcc --version')

  o GNU patch, version 2.5.4 or later (to check version run `patch
    --version')

We strongly recommend that you use the recent stable releases of the GCC,
i.e. 4.0.2, 3.4.5 or 3.3.6, if possible. We do not actively work on
supporting older versions of GCC, and they may therefore (without prior
notice) become unsupported in future releases of IT++ External.


IT++ External Configuration, Compilation and Installation
===================================================================

The basic compilation procedure resembles a standard, well-known GNU method,
i.e. 

  % ./configure
  % make

The `configure' command can be invoked with additional switches and
options (run `./configure --help' to get a list of them). There are
following switches available:

`--prefix=PREFIX'
    Set top installation directory to a certain PREFIX value. By default
    it is set to `/usr/local', so `make install' will install the
    package's files into `/usr/local/include', `/usr/local/lib`, etc.

`--libdir=DIR'
    Set libraries installation directory to a certain DIR value. By default
    it is set to `PREFIX/lib' (`/usr/local/lib'), so `make install' will 
    install the library files into `/usr/local/lib`.

`--enable-fftw' or `--disable-fftw'
    Enables or disables FFTW library compilation and installation. This 
    option is enabled by default.

`--enable-blas' or `--disable-blas'
    Enables or disables BLAS library compilation and installation. When
    enabled, ATLAS library is automatically disabled. This option is enabled
    by default.

`--enable-lapack' or `--disable-lapack'
    Enables or disables LAPACK library compilation and installation. This 
    option is enabled by default.

`--enable-cblas' or `--disable-cblas'
    Enables or disables CBLAS library compilation and installation. When
    enabled, ATLAS library is automatically disabled. This option is enabled 
    by default.

`--enable-atlas' or `--disable-atlas'
    Enables or disables ATLAS library compilation and installation. When
    enabled, reference BLAS and CBLAS libraries are automatically disabled. 
    Please note that ATLAS configuration procedure is interactive and the 
    configuration script will ask a set of questions. This option is disabled
    by default. 

`--enable-shared' or `--disable-shared'
    Enables or disables building a shared libraries if available. Currently,
    only FFTW supports shared libraries.

It is possible to change the default C/Fortran compilers and their flags by
using standard environment variables: CC, FC, CFLAGS and FFLAGS, e.g.:

  % FC="gfortran" FFLAGS="-O3" ./configure

By default, these flags are initialised with:

  o CC="gcc"
  o FC="g77"
  o CFLAGS="-O3 -pipe -funroll-all-loops"
  o FFLAGS="-O3 -pipe -funroll-all-loops"

When the configuration process is finished a status message is briefly
presented. For instance, after having invoked the following configuration
command:

  % ./configure --disable-fftw --enable-atlas

one can observe something like that:

------------------------------------------------------------------------------
itpp-external-2.1.0 configuration:
------------------------------------------------------------------------------

Directories:
  - prefix ....... : /usr/local
  - libdir ....... : /usr/local/lib

External libraries:
  - FFTW ......... : no
  - BLAS ......... : no
  - LAPACK ....... : yes
  - CBLAS ........ : no
  - ATLAS ........ : yes

Other options:
  - shared ....... : yes

Compiler flags:
  - CC ........... : gcc
  - FC ........... : g77
  - CFLAGS ....... : -O3 -pipe -funroll-all-loops
  - FFLAGS ....... : -O3 -pipe -funroll-all-loops
  
------------------------------------------------------------------------------
Now type 'make && make install' to build and install the selected libraries
------------------------------------------------------------------------------

Now, it is time for compiling and linking the IT++ External Libraries. To do
so, please simply run the following command:

  % make

IT++ External should compile without any errors or warnings. If this is not
the case, please submit a bug-report on the IT++ project page on
SourceForge. Please include information about your OS, compiler version,
etc.

Finally, you should install the compiled and linked external libraries, by
typing:

  % make install

Depending on the PREFIX settings during configuration, you might need a
root (administrator) access to success with this step.

Eventually, you might invoke the following command

  % make clean

to remove all files created during compilation process, or even

  % make distclean

to remove all files generated by the `configure' script.