Installation Instructions for the WMKONSPEC Package

The WMKONSPEC package (version 2001-Apr-16) contains IRAF tasks
useful in the reduction of NIRSPEC images:

These instructions describe how to install WMKONSPEC either as a user
package or as a layered (external) package to IRAF.  A user package
can be installed by any user, and is only available to users if their
"loginuser.cl" files contain the necessary additions.  A layered
package is layered on as part of IRAF and is available to all IRAF
users without any changes to their "loginuser.cl" file.  A layered
package can only be installed by the IRAF user.  Documentation on
layered software is found in the Site Manager's Guide that accompanied
your IRAF distribution.

[1] The package is distributed as a tar archive; IRAF is distributed
    with a tar reader.  The tar archive may be obtained by anonymous ftp.
    To obtain the package via ftp (assuming a UNIX computer):

	% ftp ftp.keck.hawaii.edu
	login: anonymous
	password: [your e-mail address]
	ftp> cd outgoing/nirspec
	ftp> get README.wmkonspec
	ftp> binary

    The package is available as a GNU compressed tar file.  Thus, do
    the following: 

	ftp> get wmkonspec.tar.gz
	ftp> quit
	% gunzip wmkonspec.tar.gz

[2] Create a directory to contain the WMKONSPEC external package files.  This
    directory should be outside the IRAF directory tree.  If WMKONSPEC is being
    installed as a layered package, then the directory must be owned
    by the IRAF account.  In the following examples, this root directory
    is named /local/wmkonspec/ (UNIX).  Make the appropriate file name
    substitutions for your site.

[3] If WMKONSPEC is being installed as a user package, then this step can be
    skipped.  If WMKONSPEC is being installed as a layered package, then the
    IRAF system must be made aware of its existence by adding it to the list
    of external packages.  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 wmkonspec to be the pathname to
    the wmkonspec root directory.  The '$' character must be escaped
    in the VMS pathname; UNIX pathnames must be terminated with a '/'.
    Edit extern.pkg to include: 

        reset   wmkonspec        = /local/wmkonspec/
        task    $wmkonspec.pkg   = wmkonspec$wmkonspec.cl

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

[4] Log into the CL from the IRAF account (if WMKONSPEC is being installed as a
    layered package) or from the user's account (if WMKONSPEC is being
    installed as a user's package), and unpack the archive file.  Change
    directories to the WMKONSPEC root directory created above and use 'rtar':

	cl> cd wmkonspec
	cl> softools
	cl> rtar -xrf ../wmkonspec.tar

[5] If WMKONSPEC was installed as a layered package then this step can
    be skipped. If it was installed as a users package, then each user
    wanting access to the package needs to put the following lines
    into his/her "loginuser.cl" file, somewhere before the "keep" command.

	reset	wmkonspec	= /local/wmkonspec/
	task	$wmkonspec.pkg	= wmkonspec$wmkonspec.cl
	reset	helpdb		= (envget("helpdb") //",wmkonspec$helpdb.mip")

    Note that this last line may well fail if the helpdb string
    exceeds 160 characters in length.