$Id: BUILDING.txt,v 1.34 2004/06/18 18:28:15 markt Exp $ Building The Tomcat 4.x Servlet/JSP Container ============================================= This subproject contains the source code Tomcat 4.x, a server that implements the Servlet 2.3 and JSP 1.2 Specifications from Java Software. 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.3 (or later) downloaded and installed (version 1.3.1 recommended), and do the following: (0) Download and Install a Java Development Kit * Download a Java Development Kit (JDK) release (version 1.3 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. (1) Download and Install the Ant Binary Distribution NOTE: Previous versions of Tomcat 4.x relied on Ant 1.3 for the build process. The 1.5 release is now required. * Download a binary distribution of Ant 1.5 or later from: http://archive.apache.org/dist/ant/binaries/ On a Windows platform, you will need: jakarta-ant-1.5-bin.zip On a Unix platform, you will need: jakarta-ant-1.5-bin.tar.gz * Unpack the binary distribution into a convenient location so that the Ant release resides in its own directory (conventionally named "jakarta-ant-1.5"). 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. (2) Download and Install the Java XML Pack Binary Distribution * 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.1.3 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.1.3 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