Installation of the JavaCGIBridge depends on what you are planning on
doing with it.  There are generally two uses.  One, just installing and
playing with the examples or two, actually figuring out what the source
code does.

If you have problems with the installation notes, email me (Gunther
Birznieks) at birzniek@hlsun.redcross.org or Selena Sol at selena@eff.org.

1. If you are installing the examples:

Move the Example1 or Example2 directory structure to an HTML readable and
CGI executable sub-directory on your web server.

Then, simply allow directories and all *.cgi files to be readable and
executable by the web server (typically chmod 755 on UNIX).  All other
files should merely be readable by the web server (typically chmod 644 on
UNIX).

Then, simply display the exampleX.html in your web browser where X is a
number depending on the example directory it was in. For example,
"example2.html" resides in the "Example2" sub-directory.  These files
contain links to sample usages of the CGI script along with a
Java applet that communicates with the same CGI script.

SPECIAL NOTE: If you need to separate your HTML and Java class files away
from executable CGI scripts, then you can place the cgi script in a
different area as long as you modify a couple files:

   a) example1.html and example2.html FORM ACTION= tags need to point to
   the different script location.

   b) The setup HTML files need to reference the CGI script as a different
   URL on the URL line of the file.

2. If you are installing it to examine the source code to the library and
peep the internals of how the JavaCGIBridge works both on the Perl/CGI
side and the Java Applet side, pay attention to the following:

a) The javadoc directory contains HTML documentation generated using the
javadoc utility. Pay particular attention to the javacgibridge.html
document in the javadoc directory.

b) The COM directory actually contains the hierarchy:

COM/Extropia/net which contains JavaCGIBridge.class and
JavaCGIBridgeTimeOutException.class (and their source code).  You should
use these packages in your java applet code if you are making your own
applets to communicate with CGI Scripts. 

Further information on how to use this class library is actually located
in the readme.usage file.

c) Example1 and Example2 directories contain sample CGI scripts and the
java applets that call them. The source code and class code to the Java
applets that are read from the example1.html and example2.html files are 
contained in the Java subdirectory under the Example1 and Example2
directories.  Notice that the Com/Extropia/net packages are contained
under these directories also (so that the applet can find the
JavaCGIBridge library).