##############################################################################
# Cliff's Voting Booth Version 1.5                                           #
# Copyright 1998 Shaven Ferret Productions                                   #
# Created 6/26/98     Last Modified 11/03/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 the return link.  If you really need to remove this  #
# stuff, 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 and use the Voting Booth
script.  You should have the following files...

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

Open vote.cgi in a text editor.  If perl is not located at /usr/bin/perl (it
probably is) change the first line of the script to #! and then the path to
perl.  Now scroll down to line 23.  If you don't want to put the data
directory in the same directory as the script, enter the server path (not the
URL) to the data directory.  Scroll down to line 27.  If you don't want your
users to be able to add topics, either delete this line or put a # in front of
it.  Scroll down to line 31.  If you want to let your users vote as many times
as they want on each topic, either delete this line or put a # in front of it.
Scroll down to line 35.  Change 13 to the number of choices you want to have
the option of adding when adding a new topic.  Scroll down to line 38 and
enter the title of your voting booth.  Finally, scroll down to line 43 and
change shavenferret.com to the password you want to use.

Now upload vote.cgi as ascii and create the data directory.  Set vote.cgi's
permissions to 755, and the data directory's permissions to 777.
Congratulations, you're done!  Vote.cgi will create its own HTML, so you can
link to it the way you would link to anything else.

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

* Can't add topics
        * Make sure that you've entered the server path (not the URL) to the
          data directory.
        * Make sure that you've created the data directory.
        * Make sure that you've set the data directory's permissions to 777.

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

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