################################################################
#                                                              #
#                        PerlDiver v1.0                        #
#          Copyright 1999 - Tintagel Consulting, LLC          #
#                    dba Script Solutions                      #
#               http://www.scriptsolutions.com/                #
#                     All rights reserved                      #
#                                                              #
################################################################

________________________________________________________________

PURPOSE OF PROGRAM:

PerlDiver v1.1 searches your web host's @INC directory, that is, 
the directory that PERL and related modules are installed in, 
and lets you know what's on your server which is available 
for your use.

Perl Diver also tells you the location of perl, the perl
executable, your path to sendmail and other useful information.

________________________________________________________________

LICENSE AGREEMENT:

By installing PerlDiver v1.1, you have agreed to indemnify, 
defend, and hold harmless Tintagel Consulting, LLC dba Script 
Solutions from any and all liability, penalties, losses, damages, 
costs, expenses, attorneys' fees, causes of action or claims 
caused by or resulting indirectly from your use of this script 
which damages either you, or any other party or parties without
limitation or exception. This indemnification and hold harmless 
agreement extends to all issues associated with this program.


________________________________________________________________

SERVER REQUIREMENTS

In order to run PerlDiver v1.1:

	1) Your web server must have the ability to run cgi 
	   programs.

	2) You must have the ability to change permissions on 
	   the cgi program.

	3) PERL 4 or higher on your web server.

	4) The File:Find perl module installed on your server.
	   If you're not sure if this is installed, please 
	   contact your server administrator.


________________________________________________________________

INSTALLATION INSTRUCTIONS

To install and run PerlDiver v1.1:

	1)  If /usr/bin/perl is your path to perl, nothing needs 
	    to be done to the perldiver.cgi file itself.  

	    If your path to perl is not /usr/bin/perl, change 
	    the first line of perldiver.cgi to your path to 
	    perl.  Simply upload perldiver.cgi into your 
	    cgi-bin, or other executable directory in ASCII 
	    format.

	    If you don't know your path to perl, and have telnet
	    access, telnet to your account and type:
	    whereis perl  

	    There, you will see a list of locations the server 
	    looks in (and finds) the perl executable, separated
	    by spaces.  Pick one, and type it in the first line
	    of perldiver.cgi.

	2)  Upload perldiver.cgi in ASCII format to your 
	    cgi-bin or other executable directory.

	2)  Change permissions on the file to 755 (NOTE: some
	    web servers may require permissions of 775 or 
	    higher for the program to run.  If in doubt, check 
	    with your server administrator.

	3)  Run the program in your browser.  

________________________________________________________________

TROUBLESHOOTING


"Internal Server Error?!?!?"

	1)  Make sure you uploaded index.cgi in ASCII format.
	    If you're not sure how to do that, consult your 
	    FTP program's instructions.

	2)  Make sure the file permissions are 755 (if you're 
	    not sure what permissions the file should be on 
	    your server, contact your server administrator)

	3)  If the above 2 don't fix it, check with your 
	    server administrator to make sure you have the 
	    File:Find program on your server available for your
	    use.


________________________________________________________________

SUPPORT

Free support is not available for our freeware programs -- we 
tried to be as comprehensive as possible in this readme.  

We offer installation services of PerlDiver for $35.00.


________________________________________________________________

CONTACT US

We welcome your comments and feedback.  You can contact us at
programmer@scriptsolutions.com


________________________________________________________________

WHERE CAN I FIND MORE FREEWARE CGI PROGRAMS?

The Perl Archive, of course.  http://www.perlarchive.com/
