##############################################################################
# Cliff's Really Nifty Guestbook Version 2.04                                # 
# Copyright 1998 Shaven Ferret Productions                                   #
# Created 6/4/98       Last Modified 1/03/2000                               #
# 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 or any of the parts that give me credit for writing     #
# this.  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 the guestbook.
You should have the following files...

        * gbook.cgi -- the script
        * gbook.txt -- the data file
        * 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/gbook/

Open gbook.cgi in a text editor.  If perl is not at /usr/bin/perl on your
system, change the first line of the script to #! and then the location of
perl (no spaces).  If you plan on putting the data file in a differant
directory from the script, change gbook.txt in line 24 to the full PATH (not
URL) of linkt.txt.   Scroll down to line 27 and change /usr/lib/sendmail
to the location of your mail program.  This should actually be ok as it is
on most unix systems.  Congratulations, you've finished configuring the
script!  Now upload gbook.cgi as ascii and set its permissions to 755.  Upload
gbook.txt as ascii and set its permissions to 600.  You'll now want to screw
with the options.

Go to the uploaded script.  At the bottom of the page, you should see a form
for administration.  Enter the password (originally "shavenferret.com",
without quotes and case sensitive), and click the button.  This will take you
to the admin page.  This is where you will go to delete and edit, entries,
add and remove images, change the setup, etc.  You'll notice at the top of the
page is a form to tell me if you find any bugs.  PLEASE use it if you find
anything.  I really didn't just put it in for the hell of it.  Scroll down to
the bottom of the page, and you'll find a form with all the nifty options.
Each one is explained in plain English, so you shouldn't have any problems.
The two things that you *really* need to change are your e-mail address and
password.

******************************************************************************
* 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 gbook.cgi to #! and 
          then the path to perl on your system
        * Make sure you've uploaded gbook.cgi as ascii, not binary.
        * Make sure you've set the permissions for gbook.cgi to 755.

* Password: shavenferret.com does not work
        * Make sure you've entered it as all lower case without quotes
        * Make sure you've uploaded gbook.txt as ascii, not binary.
        * Make sure that you've either placed the gbook.txt in the same
          directory as gbook.cgi, or entered the server path (not the URL) to
          the file in gbook.cgi
        * Make sure that you've set the gbook.txt's permissions to 773, or if
          that doesn't work on your server, 777
        * Try using a new copy of gbook.txt .  You can find one at
          http://www.shavenferret.com/scripts/gbook/download/gbook.txt

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

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