Installation of the GEMINI external package V1.7
	--------------------------------------------------

[0] This package requires IRAF version 2.12.2a or later.

[1] The package is distributed via the Gemini web pages, see
    http://www.gemini.edu/sciops/data/dataSoftware.html

    The package will also be available from the NOAO/IRAF ftp site:
    ftp://iraf.noao.edu

    You need the two files  gemini.tar.gz  and  gemini.readme which
    are both linked from the Gemini web pages.
    
    The gemini.readme file contains these instructions.

[2] gunzip the file gemini.tar.gz

        % gunzip gemini.tar.gz

[3] Create a directory to contain the GEMINI external package files.  This
    directory should be outside the IRAF directory tree and must be owned
    by the IRAF account. In the following example, this root directory
    is named /iraf/extern/gemini/ (UNIX and Linux). Make the appropriate
    file name substitutions for your site.

[4] Log in as IRAF and edit the extern.pkg file in the hlib directory to
    define the package to the CL. From the IRAF account, outside the CL,
    you can move to this directory with the commands:

	% cd $hlib

    Define the environment variable gemini to be the pathname to the gemini
    root directory. UNIX pathnames must be terminated with a '/'.  
    Edit extern.pkg to include:

	reset gemini     = /iraf/extern/gemini/
	task  gemini.pkg = gemini$gemini.cl

    Near the end of the hlib$extern.pkg file, update the definition of helpdb
    so it includes the gemini help database, copying the syntax already used
    in the string. Add this line before the line containing a closing quote:
        
                ,gemini$lib/helpdb.mip\

[5] Log into the CL from the IRAF account and unpack the archive file.  Change
    directories to the GEMINI root directory created above and use 'rtar':

	cl> cd gemini
	cl> softools
	cl> rtar -xrf <path>/gemini.tar
    
    where <path> is the relative path from /iraf/extern/gemini to the 
    downloaded file.

    You can also unpack the file gemini.tar from UNIX

        % cd /iraf/extern/gemini/
        % tar xvf <path>/gemini.tar 

[6] You only need to compile the GEMINI package if a prebuilt binary is 
    not available for your system. Executable files are provided for 
    recent versions of Solaris, RedHat Linux 7.3 (or compatible 
    distributions), and Mac OS X (compiled on v10.3.5).

    Building the package binaries requires that the following
    external packages be installed on your system, in addition to
    the standard IRAF and NOAO packages:

      tables        (http://stsdas.stsci.edu)
      fitsutil      (http://iraf.noao.edu/extern.html)

    You must also have a suitable FORTRAN compiler installed (see
    http://iraf.noao.edu/faq/FAQ.html).

    To build the binaries under iraf/extern/ as the IRAF administrator,
    first install the GEMINI package as instructed above. Ensure that
    the IRAFARCH environment variable is set correctly for your system,
    then configure the system for the desired architecture:

      cl> cd gemini$
      cl> mkpkg -p gemini <arch>
    
    where <arch> is the architecture (e.g. redhat, ssun, suse, etc.)

    Once configured, issue the following command to compile:

      cl> mkpkg -p gemini update >& gemini.spool

    On systems that concurrently support different architectures,
    repeat the commands above for each architecture.

    The spool file(s) should be reviewed upon completion to make sure
    there were no errors.

[7] To build the binaries as an end user, with the package installed
    under your home directory, you must first define a "gemini"
    environment variable as follows, before starting the CL:

       setenv gemini /home/<user>/iraf/gemini/              (csh)
       gemini=/home/<user>/iraf/gemini/ ; export gemini     (sh)

     (pointing to the directory in which you installed the package).


[8] Please use the Gemini help desk for submitting questions
    http://www.gemini.edu/sciops/helpdesk/helpdeskIndex.html
    Refer to http://www.gemini.edu/sciops/data/dataSoftware.html
    for requirements on your IRAF installation including other required
    external packages.