HOW TO INSTALL THE XSTIS IRAF PACKAGE:

Last Revised 06 July 1999

The following are instructions for installing the xstis 
package in IRAF. The xstis package consists of a group of 
tasks used by the Spectrographs Group to test new or 
modified scripts and code within the IRAF environment before
moving them to a standard package. After testing and 
approval the task(s) will be moved to teststis for internal 
use only tasks, or STSDAS for release to the GO community. 
As these tasks are considered experimental, it is not 
recommended that they be shared with General Observers.


To correctly install the XSTIS Package, and have access to 
all the internal IRAF and IDT IDL Tasks, as well as to the 
oref/ directory, do the following:


1. Edit the .envrc file in your home directory.
   Comment out the IRAF line. Uncomment the IRAFX line, the 
   IDL entry, and add a line for the new STIS package. Things 
   should end up looking like this:
        .
        .
        .
        Package: IDL
        .
        .
        .
        Package: IRAFX
        .
        .
        .
        Package: STIS
        .
        .
        .

Note: People in a GO support position need to be able to 
switch to public release IRAF at will so that they can 
see the results as the GOs do (See Ed's unix/startup 
.alias example for IRAF startup setup).


2. The package that you set up in Step #1 assumes that you 
   have no personalized set up for IRAF or IDL. So delete
   any personalized installation stuff from your other dot 
   files. You should only delete stuff that you personally 
   added to a startup file. If you have never added anything, 
   you have nothing to delete.
 
   If you have a personal .idl_startup.pro in your home 
   directory you have to make a choice:
 
     delete your version of .idl_startup.pro
 
           or

     add the contents of the file /data/garnet2/idl/idl_startup.pro
     to your version of .idl_startup.pro. 


3. To have access to the internal xstis IRAF package, add 
these lines to  your login.cl or preferentially your 
loginuser.cl file in your IRAF directory:

     set xstis = "/data/garnet2/xstis/"
     task xstis.pkg = xstis$xstis.cl
     reset helpdb = (envget ("helpdb") // ",xstis$helpdb.mip")


4. Log out of your window manager and log back in.

5. Test the set up
   a) Start up iraf
   b) type:
 
        cl> show iraf
 
   You should see 
 
        /usr/stsci/irafx

typing xstis at the cl> prompt will load the internal xstis 
package. You can also cd to oref$ from within IRAF (reference 
files directory) to verify that it is being correctly found.

6. Test IDL set up
 
   a) Start up idl
   b) type:
 
        STIS> help_stis
 
   You should have a window pop-up with help for stis 
(and many other things).
 

7.  If you have problems, send email to stis@stsci.edu.