######################################
#                                    #
# mailing.cgi v1.0 March 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:
  Mailing.cgi is a simple PERL cgi script to process html forms,
and send an email in a sensible format.

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

INSTALLATION:
  1) Place mailing.cgi in your cgi-bin, or another directory
where cgi scripts can be executed, and chmod it to 755.
  2) Edit mailing.cgi:
   a: Change the first line of mailing.cgi to reflect the
location of the PERL executable.
   b: Change the person_mail_appears_to_be_from variable as
needed.
   c: Change the default_bcc_recipient_address variable as
needed.
   d: Change the default_sendmail_command variable as needed.
   Note that in writing out an email address in the mailing.cgi
program, you will need to write @ as \@ or else the program will
have problems.
  3) Create a text form, formatted to reflect the way you would
like the emails created by mailing.cgi to be formatted.  You can
define user variables by placing the variable names between
square brackets [] as shown in the sample text form mailing.txt.  
  4) Create an html form on your page similar to the included
mailing.html which has been modified to reflect the variables on
the text form.  Be certain to have the FORM ACTION field point to
the URL of the mailing.cgi script, and to edit the hidden
location_of_text_form variable to reflect the absolute path to
the text form created.

FILES:
  COPYING
  $WEBDIR/cgi-bin/mailing.cgi
  $WEBDIR/mailing.txt
  $WEBDIR/mailing.html

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.