-$Id: BUILDING.txt 304991 2002-07-16 19:30:53Z kinman $\r
\r
- Building The Tomcat 4.0 Servlet/JSP Container With Jasper2\r
- ==========================================================\r
\r
-Jasper2 is a reimplementation of the JSP Container for Tomcat 4.0 that is\r
-cleaner and easier to extend. It also forms the basis of the JSP 2.0 \r
-implementation. Jasper2 will eventually replace the Jasper module\r
-built into the Tomcat distribution. In the meanwhile, you can build Jasper2\r
-alongside Tomcat 4.0 and replace Jasper.\r
-\r
-To build Jasper2, first make sure you have a working build environment for\r
-Tomcat 4.0. You can do so by following the instructions in the BUILDING.txt\r
-file in the Tomcat 4.0 workspace.\r
-\r
-Once you have a working build environment for Tomcat 4.0, do the following:\r
-\r
-(0) Modify your build.properties file in Tomcat 4.0\r
-\r
-* Add a line to your build.properties file for Tomcat 4.0 that\r
- points the build script to Jasper2 instead of Jasper, as follows:\r
-\r
- # ----- Jakarta Tomcat Jasper source path -----\r
- jasper.home=${base.path}/jakarta-tomcat-jasper/jasper2\r
-\r
- This directory is relative to the location of build.xml for Tomcat.\r
-\r
-(1) Use anonymous CVS (as described on the Jakarta web site at\r
- <http://jakarta.apache.org/site/cvsindex.html>, or download a source\r
- distribution of the "jakarta-taglibs" repository (7/15/2002 or later).\r
-\r
- http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/standard/\r
-\r
-* Unpack the package into a convenient location so that\r
- it resides in its own subdirectory.\r
-\r
-* Follow the instructions in BUILDING.txt to set up the correct \r
- build environment. Make sure you have a valid build.properties file.\r
-\r
-* Change directory to "standard" and build the special JSP 2.0 build target\r
- for producing the JSP 2.0 Expression Language Evaluator. The ant target\r
- is called jsp20el.dist.\r
-\r
- cd standard\r
- ant jsp20el.dist\r
-\r
-(2) Customize Build Properties for this subproject\r
-\r
-Most Jakarta subprojects allow you to customize Ant properties (with default\r
-values defined in the "build.xml" file. This is done by creating a text file\r
-named "build.properties" in the source distribution directory (for property\r
-definitions local to this subproject) and/or your user home directory (for\r
-property definitions shared across subprojects). You can use the included\r
-"build.properties.sample" file as a starting point for this.\r
-\r
-Jasper2 has external dependencies that are satisfied by configuring\r
-appropriate values in your build.properties file. The easiest\r
-way to satisfy these dependencies is to copy the "build.properties.sample"\r
-file (in the top-level Tomcat source directory) to "build.properties", and\r
-then edit it to suit your environment. On Unix, this would be done as:\r
-\r
- cd ${jasper2.source}\r
- cp build.properties.sample build.properties\r
- emacs build.properties\r
-\r
-NOTE: Be *sure* that you do not check "build.properties" in to the CVS\r
-repository. This file is local to your own development environment, and\r
-each developer will have their own version.\r
-\r
-(3) Build A Binary Distribution\r
-\r
-Jasper2 is built as part of Tomcat. Follow the instructions in \r
-BUILDING.txt in the Tomcat project to build Tomcat with Jasper2.\r
-This project is a rewrite of Jasper for tomcat 4.x.\r
-\r
-1. Main goals:\r
-\r
- * Cleanup of the current Jasper.\r
- * Use for RI work for JSP 1.3\r
- * Use for optimization work for generated servlet codes.\r
-\r
-2. Status\r
-\r
- * Main jasper engine (parser, attribute validates, code generator)\r
- basically complete.\r
-\r
-3. Todo\r
-\r
- * Rewrite attribute parser for better spec comformance.\r
- * More cleanup, especially jspc parts.\r
- * Added large file option.\r
- * Error messages.\r
- * JSR045 support\r
- * Expression language support (JSP1.3)\r
- * Optimizations, optimizations, and optimizations\r
\r
\r