Installation of the Gemini IRAF package v1.16
               ---------------------------------------------

[0] Gemini distribute and install the Gemini IRAF package with conda.
    Installation instructions can be found at
    https://www.gemini.edu/observing/phase-iii/reducing-data/gemini-iraf-data-reduction-software

    The Gemini IRAF package v1.16 should run under both IRAF and PyRAF
    environments, however it has been tested only on PyRAF.

    The Gemini IRAF package cannot be built on Mac OS 10.15 and above because
    those platforms are not distributing 32-bit compatibility libraries.
    A VM is available.  See instructions here: https://gemini-iraf-vm-tutorial.readthedocs.io/en/stable/

    The Gemini IRAF package was tested with the conda package of IRAF v2.16.


Conda Installation
-----------------------
[1] The Gemini IRAF package v1.16 is distributed and installed with conda.
    Follow the instructions on Gemini website to install.

    https://www.gemini.edu/observing/phase-iii/reducing-data/gemini-iraf-data-reduction-software

    Remember to run "mkiraf" to configure IRAF before using it for the
    first time.

    No further action is required.

    The package can also be installed manually from the tarball.  The
    installation instructions for that follow below.


Manual Installation from tarball
--------------------------------
[2] The Gemini IRAF v1.16 tarball is distributed via the Gemini web pages:

    https://www.gemini.edu/observing/phase-iii/understanding-and-processing-data/data-processing-software/download-latest

    The file gemini_v116.tar.gz is to be downloaded

    The gemini_readme.txt file contains these instructions.

[3] Create a directory to contain the Gemini IRAF package files. This
    directory should be outside the IRAF directory tree.  We will call
    that directory "my_gemini_v115".

        % mkdir my_gemini_v116

[4] Unpack the tar file in your installation directory

	% cd my_gemini_v116
	% tar xvzf <path_to>/gemini_v116.tar.gz

[5] No need to compile anything

    32-bit Linux binaries, compatible with the conda package of IRAF are already
    included with the package.  You do not need to compile anything.

[6] Configure IRAF to pick up the new package.

    In your iraf home directory (commonly ~/iraf), create a "loginuser.cl"
    file that will contain the package configuration.  The iraf home directory
    is where you ran "mkiraf", and where the login.cl is located.

	% vi loginuser.cl  (or use your favorite editor)

    Add the following lines:
        reset gemini=<full_path_to>/my_gemini_v116/
        task gemini.pkg=gemini$gemini.cl
        keep

    The trailing "/" on the first line is important, don't forget it.

[7] If updating an older installation of the Gemini IRAF package, it is
    recommended that users initialize their uparm directories by typing
    "rm uparm/*" in their iraf home directory. NOTE: if you wish to
    make a note of any stored parameters, please do so before running this
    command.

[8] Please use the Gemini HelpDesk for submitting questions
    https://www.gemini.edu/observing/helpdesk