##############################################################################
# Cliff's Links Trader Version 1.52                                          # 
# Copyright 1998 Shaven Ferret Productions                                   #
# Created 7/02/98    Last Modified 11/30/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 or any part that gives me credit for writing this.  If  #
# you really need to change these things, 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.                                            #
##############################################################################

Hello.  These are the instructions for how to install the link trader.
You should have the following files...

        * linkt.cgi -- the script
        * linkt.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/linkt

Open linkt.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 linkt.txt in line 23 to the full PATH (not
URL) of linkt.txt.   Scroll down to line 26 and change /usr/lib/sendmail
to the location of your mail program.  This should actually be ok as it is
on most unix systems.  Now scroll down to line 29 and change
http://www.yourdomain.com/cgi-bin/linkt.cgi to the the full URL of the script.
Include the domain, as this will be mentioned in e-mail.  If you receive
errors when running the script that say you don't have LWP/Simple on your
system, either delete line 32 or put a # in front of it.  Congratulations,
you've finished configuring the script!  

Upload linkt.cgi and linkt.txt as ascii (do not upload linkt.txt if you're
upgrading from version 1.0, doing so will delete your links).  Set linkt.cgi's
permissions to 755, and linkt.txt's permissions to 773.  The script will now
work, but you'll probably want to screw with the settings.

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, modify, and approve
links.  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 linkt.cgi to #! and 
          then the path to perl on your system
        * Make sure you've uploaded linkt.cgi as ascii, not binary.
        * Make sure you've set the permissions for linkt.cgi to 755.
        * Try putting a # in front of line 32.

* Password: shavenferret.com does not work
        * Make sure you've entered it as all lower case
        * Make sure that you've either placed linkt.txt in the same directory
          as linkt.cgi, or entered the server path (not the URL) to linkt.txt
          in linkt.cgi.
        * Make sure that you've set linkt.txt's permissions to 773, or if
          that doesn't work on your server, 777

* Script doesn't send e-mail.
        * Make sure that you've entered the correct path to your mail program
          in linkt.cgi.

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

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