README File for bw-contact (updated 2006-12-05 -- wew)
--

BW-Contact is a simple contact script for your web site.

You can find the latest version of BW-Contact at http://cgi.bw.org/

COPYRIGHT AND LICENSE

Copyright (c) 2003-2006 William E. Weinman.

This program is free software; You may modify and distribute it under the
same terms as perl itself.

INSTALLATION

1. Decide on a location for the script (bw-contact.cgi), the library 
files, and the html and images files. Make sure directories exist on 
the server for all of these files.

2. Edit the bw-contact.cgi script. Set the $config_path variable
to point to the configuration file (bw-contact.conf). Now edit the 
bw-contact.conf file. 

**IMPORTANT** When editing/saving the .cgi and .conf files, make sure
the line- endings are correct for your system! Usually the unix-ish
(LF) line-endings work, even on a Windows or Mac system.

3. If you are putting the library files (*.pm) in a different directory 
than the .cgi file, uncomment the "use lib" line and put the path to 
the directory containing the .pm files in between the quotes. 

NOTE: Sometimes when the .pm files are in the same directory as the 
.cgi file, you still need to uncomment the "use lib" line and put in 
the path to the libraries. This depends on how the server is configured. 

4. Edit the HTML files to taste.

5. Upload everything to the server. Be sure all the files end up in the
locations you selected in step 1.

6. Rename bw-contact.cgi if necessary for your system.

7. Set the file permissions on bw-contact.cgi to executable (755 for Unix-
ish systems).

8. Test by using your web browser with the appropriate URL for the
location on your server wher you installed the program. For example on my
server it may be http://cgi.bw.org/bw-contact/bw-contact.cgi

--
END OF README