README.txt
29 September 2000

All files are Copyright (C) 2000, Object Computing, Inc.
All Rights Reserved

Send feedback to burke_e@ociweb.com


Overview
--------
This directory contains an example of a JSP custom tag.
This tag can contain well-formed XML, which is transformed
into HTML using an XSLT stylesheet.  More documentation
can be found at OCI's Java News Brief archive
at http://www.ociweb.com/jnb.


Requirements
------------
- Tomcat 3.1  (jakarta.apache.org)
- Apache's Xalan  (xml.apache.org)
- TOMCAT_HOME, XALAN_HOME, JAVA_HOME environment variables must be set
- You must modify the tomcat.bat startup script in TOMCAT_HOME/bin
  so it includes xalan.jar and xerces.jar
  (both JAR files are included in the Xalan distribution)

Running the Examples
--------------------
1.  Copy jsp_xml.war into the TOMCAT_HOME/webapps directory
    or use the provided "install.bat"
2.  Modify TOMCAT_HOME/bin/tomcat.bat so it includes Apache's xalan.jar
    and xerces.jar in its CLASSPATH
3.  Start Tomcat as usual, or use the provided "startup.bat"
4.  Type in the following URL:
    http://localhost:8080/jsp_xml

Compiling
---------
You should not have to re-compile.  If you do, then rebuild the
code in the taglib_jar directory first.  This builds a JAR file
for the custom tag library.

Assuming that the environment variables are properly set, just
double click on the taglib_jar\makeTaglib.bat batch file.

Once that has compiled, double-click on the files in this order:
- makewar.bat
- install.bat (copies to Tomcat's webapps directory)
- startup.bat (only works if Tomcat isn't already running!)

Then visit the URL listed in step 4 above.

- shutdown.bat (stops Tomcat)
- uninstall.bat (removes the WAR file from Tomcat's directory)

