##############################################################################
# Cliff's Search Engine Position Analyzer Script Version 3.0                 # 
# Copyright 1998 Shaven Ferret Productions                                   #
# Created 6/17/98   Last Modified 9/10/99                                    #
# 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, or the part that generates the return link.  If  #
# really need to change these, go to                                         #
# http://www.shavenferret.com/scripts/register.shtml . By using this script  #
# you agree to indemnify me from any liability that might arise from its use.#
#                                                                            #
# Redistributing\selling the code for this program without prior written     #
# consent is expressly forbidden.                                            #
##############################################################################

******************************************************************************
*    IF YOU RECEIVE ERRORS INVOLVING THE LETTERS LWP, THEN YOU DON'T HAVE    *
*          LIBWWW-PERL ON YOUR SYSTEM.  IT CAN BE DOWNLOADED FROM            *
*              http://www.ics.uci.edu/pub/websoft/libwww-perl/               *
*    sorry about the caps, i just get that question a little too often...    *
******************************************************************************



Hello.  These are the instructions for how to install and use the Search
Engine Position Analyzer.  You should have the following files...

        * position.cgi ----- the script
        * position.txt ----- the data file
        * readme.txt ------- the file you're reading now

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

Open position.cgi in a text editor.  If the server path to perl 5 is not
/usr/bin/perl on your server (it usually is), change the first line to #! and
then the path to perl.  Scroll down to line 23.  If you aren't going to put
position.txt in the same directory as position.cgi, change this to the server
path of position.txt.  Finally, scroll down to line 27 and change
shavenferret.com to the password you want to use.  You will need this password
to update the data files.

The next thing to do will be to upload position.txt and position.cgi to your
server.  Set position.cgi's permissions 755, and position.txt's permissions to
777.  Make absolutely sure you upload this (and any other perl script) as
ascii, NOT binary.

To use this script, just point your web browser at the uploaded position.cgi
file.

If the script gives you an error, and you're sure that you told it the correct
location of perl, didn't upload it as binary, and chmoded it to 755, the
problem is probably that you don't have libwww-perl installed on your system.
Yell at your system administrator.  Actually, you'd probably get a better
response if you just asked politely, but yelling is just so fun...

******************************************************************************
* Troubleshooting                                                            
* If you're having problems with the script, please read the following before
* asking me for help.                                                        
******************************************************************************

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

* Some of the search engines are wrong.
        * Occasionally, search engines change their look, which throws off the
          script.  To fix this, simply point your web browser at
          http://www.shavenferret.com/cgi-bin/posupdt.cgi and follow the
          instructions.
******************************************************************************

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