* ABOUT:
  - CONTACT: Please contact gildas<at>iram.fr for any question,
        remark, suggestion.
  - VERSION: the basic rule to pick up a release is to download and
        install the latest release available on this area.
  - LABELLING: the suffix 'a', 'b', 'c' and so on indicates that an
        important bug fix or feature has been added during the month
        and this could not wait for the new release at the beginning
        of next month. Such new releases include only these
        modifications, and not all the on-going developpements. Check
        the NEWS section for details on the augmented release.
  - STABILITY: Developpers usually stabilize (if needed) Gildas before
        each release. Nevertheless, some developments take time and in
        such a case monthly releases may be skipped. From time to
        time some releases are suffixed "beta": this indicates that
        important developments were done and this version is a
        candidate for a stable release. It is "stable as far as we
        know", but not tested enough.
  - REFERENCE VERSION: Finally, the apr11 release (April 2011) is a
        particular version used at the telescopes. If a newer version
        is available, standard users should not install it, unless
        they have been told to. There are bug fixes, improvements, and
        features which have been added in the latest releases, but
        which won't be in the apr11 release because they do not affect
        the operations at the telescopes.

* INSTALL UNDER LINUX:
  - If GILDAS dependencies are correctly installed, building the binaries
    should just need the following sequence of commands:
      shell-prompt> gunzip gildas-src-mmmyya.tar.gz  
      shell-prompt> tar -xvf gildas-src-mmmyya.tar  
      shell-prompt> cd gildas-src-mmmyya  
      shell-prompt> source admin/gildas-env.sh [-c compiler] 
    Read carefully the messages and warnings returned by the command. If
    all seems correct, then compile and install Gildas:
      shell-prompt> make  
      shell-prompt> make install 
    Then follow the instructions at the end of the make install process.

* INSTALL UNDER LINUX (32 bits binaries under 64 bits machines):
            *** This compilation mode is OBSOLETE ***
  - You may need to build 32 bits binaries under 64 machines. This is not
    recommended unless you have been told to. The administrative scripts
    are able to build 32 bits binaries when the "32bits" configuration is
    invoked:
      source admin/gildas-env.sh -o 32bits
    Please check the output messages carefully. Especially, the following
    are required:
  - As of feb 2nd, 2011, only the Intel Fortran Compiler (ifort) is
    supported. You will have to use the 32 bits executable of your
    compiler. Ifort is shipped with both 32 and 64 bits executables,
    check its installation path and your PATH environment variable.
  - Your administrator will have to install the 32 bits versions of the
    Gildas dependencies. This is usually well supported by the packages
    managers of Linux distribution (clear separation /usr/lib vs
    /usr/lib64). If some 32 bits dependencies are missing, the linker will
    warn you that it "skips such incompatible library", and will complain
    that it can not find the library it was looking for.
  - For non standard installation (i.e. custom local path), remember you
    can add by hand paths sent to the linker, e.g.
      GAG_FLDFLAGS=-L/home/me/path/to/some/lib
    You will also need the same when linking Gildas C executables:
      GAG_CLDFLAGS=-L/home/me/path/to/some/lib
    This is required only once, at build time.
  - At run time if you encounter the error "error while loading shared
    libraries", make sure that your LD_LIBRARY_PATH provides the path
    to the 32 bits version of the required library.
  - CFITSIO is required to build Mira. If you compile it by yourself,
    you will have to build a 32 bits library. Adding the following option
    to your 'configure' call should help:
      ./configure CFLAGS=-m32

* UNINSTALL UNDER LINUX:
  - Except if you want to save disk space, you have no need to uninstall
    any previous Gildas installation. Each version goes into its own
    'gildas-src-*' and 'gildas-exe-*' directories. The default version
    used is ruled by the environment variable $GAG_ROOT_DIR that is set
    in user's ~/.bash_profile. You can modify it as you want to point to
    the desired version.
  - Remember to start a new terminal each time you modify your
    ~/.bash_profile .
  - For a complete uninstall of Gildas, just remove the directories
    'gildas-src-*' and 'gildas-exe-*', and suppress the lines related
    to Gildas in your ~/.bash_profile

* INSTALL UNDER MS WINDOWS (E.Reynier & S.Guilloteau & J.Pety 03-apr-2009):
  - Disclaimer: GILDAS under Windows is supported on a best effort
    only.
  - Get the Gildas installation package called gildas-www-nnnnn.exe
    where "nnnnn" indicate the release date, from
    http://www.iram.fr/~gildas/dist
  - Execute the installation package. Choose a destination folder name
    without white spaces. Under Windows Vista, choose the "just for
    me" installation option.
  - Edit the gag.dico.lcl file to specify your Gildas preferences.