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 gunther@clark.net.

1. If you are installing the examples:

Move the Example directory structures 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/index.html file in your web browser
where X is a number depending on the example directory it was in. For
example, the second example resides in the "Example2" sub-directory.
Thesefiles 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) index.html files which reference CGI scripts from the HTML need
      to have their <FORM ACTION=XXXX> tags modified 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. These files are called setup.html
   and reside in the relative ExampleX sub-directories.

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. A good starting point is "tree.html".  This was
generated for the public API.

If you want to see the entire API including private and protected methods
and data, you can view them in the javadoc/all sub-directory.  Again,
"tree.html", is a good starting point here.

b) All the Java source code is contained in the Java directory.

The actual JavaCGIBridge classes reside under this directory under
com/extropia/net.  This is because the JavaCGIBridge framework was
written under the com.extropia.net package name.

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

c) The source code to the Java code for the examples as well
as JavaCGIBridge reside in the same subdirectories as the class files
themselves.