######################################
#                                    #
# picksig.cgi v0.92 November 2003    #
#                                    #
# Written by Scott David Gray        #
#                                    #
# Contact:                           #
#  Scott David Gray                  #
#                                    #
# email: sgray@sudval.org            #
#                                    #
# URL: http://unseelie.org           #
#                                    #
# (c) 2001-2003 by Scott David Gray  #
#                                    #
######################################

DESCRIPTION:
  Picksig.cgi is a simple PERL cgi script to select a random file
from a list, and insert it into an html document.

UNPACKING:
  gzip -cd picksig-cgi-v0.92.tgz | tar xpf -

INSTALLATION:
  1) Place picksig.cgi in your cgi-bin, or another directory
where cgi scripts can be executed, and chmod it to 755.
  1) Place listsig.cgi in your cgi-bin, or another directory
where cgi scripts can be executed, and chmod it to 755.
  3) Edit picksig.cgi:
   a: Change the first line of picksig.cgi to reflect the
location of the PERL executable.
   b: Place the sigs directory somewhere accesible to the PERL
script.
   c: Place the sigfile file somewhere accesible to the PERL
script.
  4) Edit listsig.cgi:
   a: Change the first line of listsig.cgi to reflect the
location of the PERL executable.
  5) Create the .shtml file which will contain the random quote.  
Follow the format suggested in the sample index.shtml.
  6) Make certain that the absolute path for each of the .sig
files is listed in the sigfile file.  Try entering the sigs
directory and issuing the command:
    for i in *.sig ; do echo "$PWD/$i" ; done > path/to/sigfile

TODO:
  Have program find .sig files in the sigs directory, rather than
reading in a list from the sigfile file.

FILES:
  COPYING
  $WEBDIR/cgi-bin/listsig.cgi
  $WEBDIR/cgi-bin/picksig.cgi
  $WEBDIR/sigfile
  $WEBDIR/sigs/*.sig
  $WEBDIR/index.shtml

LICENSE:
  This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
  This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.
  You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
USA.