# English to Metric Conversion Program
# Version 2.0
# README File
# By Mike Calabrese
# http://www.mikecalabrese.com
# 07-16-2003

# This program is available for free on an AS-IS basis.  I am not
# responsible for consequential damages, loss of income or whatever
# else that may happen as a result  of the use of this program.

This program is designed to take a given input distance in either
inches, feet, yards or miles and convert them to centimeters, meters
or kilometers.  The 3 files included are
this README file, the Perl script enmeco.pl and the HTML page that
points to this script called enmeco.html.  This script has been tested on
UNIX and LINUX environments successfully.

The following configuration changes need to be made in order to successfully
run this program:

1) Place the HTML page enmeco.html on your server where your other HTML
documents reside.  Be sure to change the "FORM ACTION" line to point to
the url location of enmeco.pl.  (For example-
 )
Please note that on some servers you have to change the extension of the Perl
script from .pl to .cgi.

2) Place the perl script enmeco.pl in your cgi-bin directory within a
directory called enmeco.  Be sure to chmod both this file to and the directory
you created to 755.  On some servers you will have to chown this file to
the proper ownership name for your site.  The only 2 things in this file that
need to be changed are:
a) Make sure that your path to Perl is correct (typing "which perl" at the
command line will answer that. Also, be sure that the path to Perl is the very
first line in the script.
b) Make sure that the $refurl variable is set to the exact url path to your
enmeco.html file.  The bad referer subroutine keeps others from copying your
html form and pointing to your cgi.

Changes to version 2.0 include changes to the variable naming scheme within
this app.