######################################
#                                    #
# users.cgi v1.0 April 2002          #
#                                    #
# Written by Scott David Gray        #
#                                    #
# Contact:                           #
#  Scott David Gray                  #
#                                    #
# email: sgray@sudval.org            #
#                                    #
# URL: http://unseelie.org           #
#                                    #
# (c) 2001, 2002 by Scott David Gray #
#                                    #
######################################

DESCRIPTION:
  Users.cgi is a simple PERL cgi script to list (with links) all
subdirectories of any specific directory on the same machine that
contain index files.

UNPACKING:
  gzip -cd userspage-cgi-v1.0.tgz | tar xpf -

INSTALLATION:
  1) Place users.cgi in your cgi-bin, or another directory where
cgi scripts can be executed, and chmod it to 755.
  2) Edit users.cgi:
   a: Change the first line of users.cgi to reflect the
location of the PERL executable.
   b: Change the dirlocation variable as needed.
   c: Change the machinename variable as needed.
   d: Change the urlplace variable as needed.
   e: Change the maxaliaslength variable as needed.
   f: Change the maxcommentlength variable as needed.
  3) Create the .shtml file which will reference the
subdirectories.  Follow the format suggested in the sample
index.shtml.

INSTRUCTIONS:
  In order to appear in the list, a directory must contain a file
named index.htm or index.html.
  Users can hide their directory from view by the users.cgi
program, by placeing a file named .stealth in the directory.
  Users can have a different name for the link appear in the list
in place of the directory name, by putting creating a file named
.alias which contains the new name for the link.
  Users can add a comment, which appears on the list after the
link, by creating a file named .comment which contains the
comment.

FILES:
  COPYING
  $WEBDIR/cgi-bin/users.cgi
  $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.