# Web Dice Program
# Version 1.0
# Web Dice README File
# By Mike Calabrese
# http://www.mikecalabrese.com
# 03-04-2004

# This application 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 application is designed to let one virtually roll from one to six dice 
and get random results.

The way that the program works is as follows.  The user simply chooses how  
many dice that they want to roll from the drop down menu.  They then click 
on the 'Roll the Dice' button, and the results are displayed on the next 
screen.  The dice can then be rolled over and over again and will give back 
random results.

The following configuration changes need to be made to this app in order for 
it to successfully run on your UNIX or Linux server:

Within the area where your HTML documents are stored, create a directory 
called dice.  Chmod this directory to 755.  Place the file dice.html within  
this directory. Chmod this file to 755.  The only configuration change is to 
be sure that the POST statement within dice.html points to 
cgi-bin/dice/dice.pl within your server. If you downloaded the tarred and 
zipped directory containing the 6 dice images, place it here.  Be sure to 
follow the instructions telling how to untar and unzip this directory.  Be 
sure to chmod this directory to 755 and all of the images inside of it to 
755 as well. If you simply copied the dice images from the application,  
create a directory called dice_images within the directory dice in your HTML 
documents area. Chmod this directory to 755.  Place the 6 dice images within 
this directory.  Chmod these images to 755. 

In the area wher your cgi-bin files are stored, create a directory called 
dice. Chmod this directory to 755.  Place the file dice.pl within this 
directory.  Chmod this file to 755.  Within this file, make the following 
configuration changes: 

Line 1- Make sure that the path to Perl is correct and that this is the first 
line of your script.

Line 13- Replace yourdomain.com with the name of your domain.  This block of 
code keeps others from 'hijacking' your form.

Line 18- Replace the url path within the quotes with the exact url path to 
your HTML dice_images directory.  Do not include a forward slash at the end of 
the path.  This tells the app where to pull the dice images from.

If your paths are set correct and your permissions are correct, then this 
app should run with no problems.