The PIRLswishe Package

	Copyright (C) 2002 Arizona Board of Regents on behalf of the
	Planetary Image Research Laboratory, Lunar and Planetary Laboratory
	at the University of Arizona

    Planetary Image Research Laboratory (PIRL)


INSTALLATION

    These programs are meant to be used with the SWISH-E program.
    If you don't have it installed, they'll be kinda useless.
    So first off, go to the SWISH-E webpage (http://www.swish-e.org),
    and install SWISH-E.

If you only have one CGI program that uses PIRLswishe.pm, just put
PIRLswishe.pm in the directory with it, and Perl will find it.

If you have several CGI (or other) Perl programs that use it,
you might find it convenient to actually install it in the 
regular Perl way.

This can be done with the following steps:

    perl Makefile.PL  # generate the Makefile
    make install      # install the module file

When you generate the Makefile with the first step, you will
be asked two questions.

    1. The Shebang Line
        I always forget to change the shebang line (the first line
        of a Perl program that often goes #!/usr/bin/perl) in 
        programs that I get from others, so the first question asks
        you what your system's shebang line should be.  The only
        thing this does is rewrite the first line of PIRLsearch.cgi
        as a convenience for you.  If you screw it up or change your
        mind, just edit the file by hand.

    2. Path for SWISH-E
        Makefile.PL will try to guess the path to your SWISH-E executable,
        but if it gets it wrong or can't find it, you can enter it by
        hand.  Again, this is just a convenience.  The only thing this
        does is fill out a default variable in the PIRLswishe.pm module.
        If you screw it up, or change your mind, you can always override
        that variable when you call the PIRLswishe subroutines, or just
        go in and edit the $swishe_executable_path variable, no big deal.

After that, it will spit out the Makefile, and the only thing that
does is install PIRLswishe.pm somewhere where your version of Perl
knows it is and then any program can call on it with a "use PIRLswishe;"
line.