About EsoRex
-------------

This is version 3.9.0 of the EsoRex application. This package includes
source files to build the "esorex" executable, which allows the running
of Common Pipeline Library (CPL) plugins. Also included is the
documentation and the installation procedures.


Prerequisites
--------------

For installing the EsoRex software you require:

  * An ISO-C compiler (preferably GNU gcc v3.9 or later)
  * CPL (version 5.2 or later - available from the CPL web site at ESO)
  * CFITSIO (version 3.09 - also available from the website above)
    Esorex itself does not use any function from the CFITSIO library,
    but has to link against CFITSIO due to CPL
 
EsoRex also uses the GNU libtool (version 2.2.6), however, this is provided
with the EsoRex distribution, and does not need to be obtained separately.


Installation
------------

In order to be able to install the EsoRex tool from the source code,
you will need an installed version of the CFITSIO and CPL libraries (see
the Prerequesites, above).

To install EsoRex, unpack the tar-archive in a directory of your
choice, enter the created "esorex" directory, and run the following
commands (for more information about the options for the configure
script, please read the INSTALL file, that comes with this
distribution).

  %  ./configure --prefix=<where-esorex-will-be-installed> \
                 --with-cpl=<where-cpl-is-installed> \
                 --with-cfitsio=<where-cfitsio-is-installed>
  %  make
  %  make install


An alternative to specifying with command-line parameters in the configure command
line where CPL and CFITSIO may be found, 
is to set the environment variables CFITSIODIR and CPLDIR accordingly.

  

Reporting Bugs
--------------

Please report any bugs to <cpl-help@eso.org>. See also the BUGS file 
included in the EsoRex distribution.

110111