
  These are minimal instructions for getting started with the X-shooter pipeline.

Requirements
============

Before this package can be built the components

    CPL
    QFITS
    esorex

must have been already installed. These packages are available from the
CPL download page

    http://www.eso.org/observing/cpl/download.html

Alternatively, the three packages are installed together with the UVES
pipeline recipes available from

    ftp://ftp.hq.eso.org/pub/dfs/pipelines/uves-cpl/

Additionally, the GNU development tools

    GNU autoconf 2.59 or newer
    GNU automake 1.8 or newer
    GNU libtool 1.5 or newer

must be installed.


Building
========

The following mantra

    ./bootstrap
    ./configure --prefix=<install-dir>
    make
    make install

will build and install the pipeline recipes.

A simple, stand-alone CPL application can be built (depending heavily
on the identity of the local C-compiler and the environment in
general) with

    gcc -I$CPLDIR/include/ -L$CPLDIR/lib -lcplcore hello_cpl.c


Running
=======

A recipe can be executed using EsoRex

    esorex --recipe-dir=<install-dir> xsh_rrrecipe tests/sof/uvb/xsh_rrrecipe.sof

See also esorex --help.


Further information
===================

For information about CPL and writing VLT pipelines get

    CPL User Manual
    CPL Reference Manual
    CPL Technical Developers Manual

from the CPL download page

    http://www.eso.org/observing/cpl/download.html

For documentation of the X-shooter pipeline itself run

    make html

and point a browser to html/index.html.
