##############################################################################
# Cliff's 404 Finder Version 1.01                                            # 
# Copyright 1998 Shaven Ferret Productions                                   #
# Created 7/9/98        Last Modified 9/13/98                                #
# Available at http://www.shavenferret.com/scripts                           #
##############################################################################
# COPYRIGHT NOTICE                                                           #
# Copyright 1998 Shaven Ferret Productions All Rights Reserved.              #
#                                                                            #
# This script can be used\modified free of charge as long as you don't       #
# change this header thing.  By using this script you agree to indemnify     #
# me from any liability that might arise from its use.  In simple English,   #
# if this script somehow makes your computer run amuck and kill the pope,    #
# it's not my fault.                                                         #
#                                                                            #
# Redistributing\selling the code for this program without prior written     #
# consent is expressly forbidden.                                            #
##############################################################################

Hello.  These are the instructions for how to install and use the 404 Finder.
script.  You should have the following files...

        * 404.cgi ---- the script
        * 404.txt ---- the data file
        * 404.html --- an example of a page to send people to
        * readme.txt - the file you're reading now

If you're missing any of these files, you can download them from
http://www.shavenferret.com/scripts/404/

******************************************************************************
* Installation                                                            
******************************************************************************

Open 404.cgi in a text editor.  If perl cannot be found at /usr/bin/perl on
your system, change /usr/bin/perl in the first line to the location of perl.
If you won't be putting the 404.txt in the same directory as 404.cgi, change
404.txt in line 23 to the PATH (not URL) of the data file.  Scroll down to
line 26, and change http://www.yourdomain.com to the URL of your main page.
If you have a search engine, scroll down to line 29 and enter it's URL between
the quotes.  Scroll down to line 32, and change shavenferret.com to the
password you want to use.  Upload the files, and set the 404.cgi's permissions
to 755 and 404.txt's to 777.

If you have an .htaccess file, just add the following line to it:
ErrorDocument 404 /cgi-bin/404.cgi?404 
Make sure to change /cgi-bin/404.cgi to the URL of 404.cgi

If you don't, create a blank text file, and add the following line to it:
ErrorDocument 404 /cgi-bin/404.cgi?404
Make sure to change /cgi-bin/404.cgi to the URL of 404.cgi
Save the file as .htaccess, and upload it as ascii to your root directory.

Congratulations, you're done!  When you want a report on the referring URLs,
just go to the script.

******************************************************************************
* Troubleshooting                                                            
******************************************************************************

* Script returns 500 Internal Server Error
        * Make sure you've changed the first line of 404.cgi to #! and then
          the path to perl on your system
        * Make sure you've uploaded 404.cgi as ascii, not binary.
        * Make sure you've set the permissions for 404.cgi to 755.

* Script doesn't record referring URL's
        * Make sure you've either placed 404.txt in the same directory as
          404.cgi, or entered the server path (not the URL) to 404.txt in
          404.cgi.
        * Make sure you've set 404.txt's permissions to 777.

******************************************************************************

                        If you still need help, go to
                http://www.shavenferret.com/scripts/help.shtml