Installation of the GEMINI external package V1.9 Beta
	--------------------------------------------------

                      !!!!!!WARNING!!!!!!!

You are about to install a beta release of V1.9 that has been issued for 
the benefit of the NIFS SV PIs only.  This is *not* a fully tested package. 

       ****************************************************
       ** This package should not replace Gemini v1.8.1. **
       ****************************************************

The instructions below will install this beta package in any directory
own by the user.  Instruction are also given as to how to make IRAF
pick up that beta package instead of the Gemini package in the IRAF extern
directory.

                      !!!!!!!!!!!!!!!!!!!!

[0] This package requires IRAF version 2.12.2a or later.  This package
    also requires the latest version of the FITSUTIL external package.

[1] The package is distributed via the Gemini web pages, see

    http://www.gemini.edu/sciops/instruments/nifs/NIFSReduction.html

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

[2] gunzip the file gemini-v19beta.tar.gz

        % gunzip gemini-v19beta.tar.gz

[3] Create a directory to contain the GEMINI external package files.  This
    directory can be in any directory you own. In the following example, 
    this root directory is named /home/<user>/extern/gemini/.  Make the 
    appropriate directory name substitutions for your site.

[4] Go to the directory where your "login.cl" lives.  Usually this is
    ~/iraf/.  Make sure the following lines in "login.cl" are uncommented:
    
        if (access("home$loginuser.cl"))
            cl < "home$loginuser.cl"
        ;
    
    Now, create or edit the file "loginuser.cl" with these instructions:
    
        reset gemini = "/home/<user>/extern/gemini/"
        task gemini.pkg = "gemini$gemini.cl"
        keep

[5] Log into the CL from your 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-v19beta.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 /home/<user>/extern/gemini/
        % tar xvf <path>/gemini-v19beta.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 9 (or compatible 
    distributions), and Mac OS X (v10.4.*).  

    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 as an end user, with the package installed under your
    home directory, as explained above, first install the GEMINI package as 
    instructed above. Ensure that the IRAFARCH environment variable is set 
    correctly for your system.  Then you must 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).
    
    
    Then launch the CL and 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

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

[7] Please forward software issues relating to *this* beta release to
    Kathleen Labrie (klabrie@gemini.edu).  Questions and issues regarding
    the NIFS data, and the data reduction process should be sent to
    Tracy Beck (tbeck@gemini.edu).  Any other questions should be submitted
    to the Gemini help desk (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.