Apache Tomcat Connectors
                          ========================


Introduction
============

This CVS module contains the code for the Tomcat Connectors. It currently
contains two distinct connectors: jk and webapp. This module also contains
utility classes that are used by the connectors as well as Tomcat itself.
The components are:

Connectors
----------

* jk: The native and java parts of the ajp12/ajp13 connector.
  Both Tomcat 4.0 and Tomcat 3.3 are supported. This also includes
  mod_jk for integration with various frontend webservers (like
  Apache).

* webapp: The native and java parts of the warp connector. This
  includes mod_webapp for integration with frontend webservers.

Utilities
---------

* coyote: A reflexion framework +/- of what is needed to handle HTTP requests
  in Tomcat (in java). These utilities are not intended for user code.
  They are used internally by Tomcat.

* util: A set of APIs used by Tomcat. Note: these came from Tomcat 3.3
  and were extracted here for general use.


Building Apache Tomcat Connectors
=================================

It is not necessary to build and install both connectors. [ Talk about
tradeoffs between jk and webapp. Perhaps reference some other documentation
that already does this. ]

* If you wish to build the 'jk' connector, see the documentation in 
  jk/README.txt for the java implementation, and jk/native/README.configure
  for help with the native Apache module.

* If you wish to build the 'webapp' connector, see the documentation in
  webapp/README.txt.


Installing Apache Tomcat Connectors
===================================

[ This could use some serious work. There are a few factors that make this
  more complicated than it should be, namely using 'jk' vs 'webapp', and
  then how to install and configure for both TC 3.3 and TC 4.0. ]

[ Notes: from thread on tomcat-dev around Jun 20th:
  We have a limited amount of install scripts (see jk/native/apache-1.3
  for example), and may wish to expand these to cover the build.xml/jars.
  It would also be good (IMHO) to put instructions for doing the same
  here or at least have this document direct people to the appropriate
  docs under jk/ or webapp/. ]