$Id: BUILDING.txt 719712 2008-11-21 21:08:55Z markt $ Building The Tomcat 4.1 Servlet/JSP Container ============================================= This subproject contains the source code Tomcat 4.1, a server that implements the Servlet 2.3 and JSP 1.2 Specifications. In order to build a binary distribution version of the container from a source distribution, you must have a Java Development Kit (JDK) for version 1.4 (or later) downloaded and installed and do the following: (1) Download and Install a Java Development Kit * Download a Java Development Kit (JDK) release (version 1.4 or later) from: http://java.sun.com/j2se/ * Install the JDK according to the instructions included with the release. * Set an environment variable JAVA_HOME to the pathname of the directory into which you installed the JDK release. * Tomcat 4.1 may be built using a 1.3 JDK but this will not create a full binary distribution. The documentation web application is one of the components that will be excluded when building with a 1.3 JDK (2) Download and Install the Ant Binary Distribution * Download a binary distribution of Ant 1.5 or later from: http://ant.apache.org/bindownload.cgi On a Windows platform, you will need: apache-ant-1.7.0-bin.zip On a Unix platform, you will need: apache-ant-1.7.0-bin.tar.gz * Unpack the binary distribution into a convenient location so that the Ant release resides in its own directory (conventionally named "apache-ant-1.7.0"). For the purposes of the remainder of this document, the symbolic name "${ant.home}" is used to refer to the full pathname of the release directory. * Modify the PATH environment variable to include directory "${ant.home}/bin" in its list. This makes the "ant" command line script available, which will be used to actually perform the build. (3) Download and Install the Java XML Pack Binary Distribution * This is optional with JDK 1.4 or later. * Download a binary distribution of Java XML Pack: http://java.sun.com/xml/downloads/javaxmlpack.html * Unpack the binary distribution into a convenient location so that the Java XML Pack release resides in its own directory (the JAXP libraries reside in the jaxp-1.2_01 subdirectory). For the purposes of the remainder of this document, the symbolic name "${jaxp.home}" is used to refer to the full pathname to the jaxp-1.2_01 subdirectory of the Java XML Pack release directory. * Make the "xalan.jar" file of this distribution available to Ant (so that it can be used with the