craigmcc 01/07/14 21:08:55
Modified: . README
doc installation.xml
doc/userGuide building_controller.xml
Log:
Various docco updates to reflect the new requirements for the Jakarta
Commons packages. NOTE: I'm not sure I've gotten them all yet ...
Revision Changes Path
1.14 +5 -4 jakarta-struts/README
Index: README
===================================================================
RCS file: /home/cvs/jakarta-struts/README,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- README 2001/03/24 00:05:36 1.13
+++ README 2001/07/15 04:08:55 1.14
@@ -1,4 +1,4 @@
-$Id: README,v 1.13 2001/03/24 00:05:36 craigmcc Exp $
+$Id: README,v 1.14 2001/07/15 04:08:55 craigmcc Exp $
Struts
======
@@ -76,8 +76,9 @@
- (*) Copy the files "lib/struts*.tld" from the Struts distribution into the
"WEB-INF" directory of your web application.
-- (*) Copy the file "lib/struts.jar" from the Struts distribution into the
- "WEB-INF/lib" directory of your web application.
+- (*) Copy the JAR files from the "lib" directory of the Struts distribution
+ (such as "struts.jar" and "commons-*.jar") into the "WEB-INF/lib" directory
+ of your web application.
- (*) Modify your "WEB-INF/web.xml" file to include a <servlet> element to
define the controller servlet, and a <servlet-mapping> element to establish
@@ -107,7 +108,7 @@
(If you wish, you can use a prefix other that "struts-bean").
- When compiling your web application components, be sure that the
- "struts.jar" file (copied above) is included on the CLASSPATH environment
+ JAR files (copied above) are included on the CLASSPATH environment
variable used by your Java compiler.
1.7 +42 -11 jakarta-struts/doc/installation.xml
Index: installation.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/installation.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- installation.xml 2001/07/05 11:42:07 1.6
+++ installation.xml 2001/07/15 04:08:55 1.7
@@ -48,6 +48,17 @@
distribution from
<a href="http://jakarta.apache.org/builds/jakarta-servletapi";>here</a>.
</li>
+ <li><strong>Jakarta Commons Packages</strong> - Struts utilizes several
+ packages from the <a href="http://jakarta.apache.org/commons/";>Jakarta
+ Commons Project</a>. If you are utilizing a binary distriubtion of
+ Struts, the corresponding JAR files are included in the <code>lib</code>
+ directory. However, if you wish to build Struts from source, you will
+ need to download and install the following packages:
+ <ul>
+ <li><em>Beanutils</em> (Version 1.0 or later)</li>
+ <li><em>Collections</em> (Version 1.0 or later)</li>
+ <li><em>Digester</em> (Version 1.0 or later)</li>
+ </ul></li>
<li><strong>JDBC 2.0 Optional Package Classes</strong> - Struts supports
an optional implementation of <code>javax.sql.DataSource</code>, so it
requires the API classes to be compiled. They can be downloaded from
@@ -100,6 +111,12 @@
<li><strong>catalina.home</strong> - Pathname to the directory of your
binary distribution of Tomcat 4.0 (required only if you wish to
use the <code>deploy.catalina</code> target).</li>
+ <li><strong>commons-beanutils.jar</strong> - Pathname of the BeanUtils
+ package JAR file from the Jakarta Commons project.</li>
+ <li><strong>commons-collections.jar</strong> - Pathname of the
+ Collections package JAR file from the Jakarta Commons project.</li>
+ <li><strong>commons-digester.jar</strong> - Pathname of the
+ Digester package JAR file from the Jakarta Commons project.</li>
<li><strong>servletapi.home</strong> - Pathname to the directory of
your binary distribution of the Servlet API classes.</li>
<li><strong>tomcat.home</strong> - Pathname to the directory of your
@@ -130,11 +147,13 @@
files included in a binary distribution of Struts, as described
in the following section.</p>
- <p>IMPORTANT NOTE: The <code>struts.jar</code> must be in your classpath when
- compiling Struts. The <code>build.xml</code> provided does this automatically.
- If you use your development machine to test Struts application locally, be
- sure that the <code>stuts.jar</code> is NOT on your classpath when your
- container is running. </p>
+ <p>IMPORTANT NOTE: The <code>struts.jar</code>, as well as the JAR files
+ from the Jakarta Commons project, must be in your classpath when
+ compiling Struts. The <code>build.xml</code> provided does this
+ automatically. If you use your development machine to test Struts
+ application locally, be sure that the <code>stuts.jar</code> is
+ <strong>NOT</strong> on your classpath when your container is running.
+ </p>
</section>
@@ -153,6 +172,14 @@
distribution consists of the following contents:</p>
<ul>
+ <li><strong>lib/commons-*.jar</strong> - These JAR files contain packages
+ from the Jakarta Commons project that are utilized within Struts
+ itself. When you assemble a Struts-based application, you will need
+ to copy these files to the <code>WEB-INF/lib</code> directory.</li>
+ <li><strong>lib/jdbc2_0-stdext.jar</strong> - The JDBC 2.0 Optional Package
+ API classes. You will need to copy this file to your
+ <code>WEB-INF/lib</code> directory if you are utilizing the data
+ sources support provided by Struts.</li>
<li><strong>lib/struts.jar</strong> - This JAR file contains all of the
Java classes included in Struts. It should be copied into the
<code>WEB-INF/lib</code> directory of your web application.
@@ -162,7 +189,7 @@
supported by your container. Be advised that this will like cause you
to encounter ClassNotFoundException problems unless <em>all</em> of
your application classes are stored in the shared repository.</li>
- <li><strong>lib/struts*.tld</strong> - These are the "tag library
+ <li><strong>lib/struts-*.tld</strong> - These are the "tag library
descriptor" files that describe the custom tags in the various Struts
tag libraries. They should be copied into the <code>WEB-INF</code>
directory of your web application.</li>
@@ -196,10 +223,13 @@
<p>To use Struts in your own application, you will need to follow
these steps:</p>
<ul>
+ <li>Copy the files <code>lib/commons-*.jar</code> from the Struts
+ distribution into the <code>WEB-INF/lib</code> directory of your
+ web application.</li>
<li>Copy the file <code>lib/struts.jar</code> from the Struts distribution
into the <code>WEB-INF/lib</code> directory of your web application.
</li>
- <li>Copy the all of the files that match <code>lib/struts*.tld</code>
+ <li>Copy the all of the files that match <code>lib/struts-*.tld</code>
from the Struts distribution into the <code>WEB-INF</code> directory
of your web application.</li>
<li>Modify the <code>WEB-INF/web.xml</code> file for your web application
@@ -218,8 +248,8 @@
</taglib>
<taglib>
- <taglib-uri>/WEB-INF/struts-form.tld</taglib-uri>
- <taglib-location>/WEB-INF/struts-form.tld</taglib-location>
+ <taglib-uri>/WEB-INF/struts-html.tld</taglib-uri>
+ <taglib-location>/WEB-INF/struts-html.tld</taglib-location>
</taglib>
<taglib>
@@ -244,14 +274,15 @@
</ul>
<pre><@ taglib uri="/WEB-INF/struts-bean.tld" prefix="struts-bean" %>
-<@ taglib uri="/WEB-INF/struts-form.tld" prefix="struts-form" %>
+<@ taglib uri="/WEB-INF/struts-html.tld" prefix="struts-html" %>
<@ taglib uri="/WEB-INF/struts-logic.tld" prefix="struts-logic" %>
<@ taglib uri="/WEB-INF/struts-template.tld" prefix="struts-template" %>
</pre>
<ul>
<li>When compiling the Java classes that comprise your application, be sure
- to include the <code>struts.jar</code> file (copied earlier) on the
+ to include the <code>struts.jar</code> and
+ <code>commons-*.jar</code> files (copied earlier) on the
CLASSPATH that is submitted to the compiler.</li>
</ul>
</section> <section name="Installing Struts with your servlet container"
href="Containers">
1.2 +4 -2 jakarta-struts/doc/userGuide/building_controller.xml
Index: building_controller.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/building_controller.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- building_controller.xml 2001/03/18 17:48:59 1.1
+++ building_controller.xml 2001/07/15 04:08:55 1.2
@@ -608,8 +608,10 @@
<section name="4.5.4 Add Struts Components To Your Application"
href="config_add">
<p>
- To use struts, you must copy the .tld files that you require into your
- WEB-INF directory, and copy struts.jar into your WEB-INF/lib directory.
+ To use Struts, you must copy the .tld files that you require into
+ your <code>WEB-INF</code> directory, and copy <code>struts.jar</code>
+ (and all of the <code>commons-*.jar</code> files) into your
+ <code>WEB-INF/lib</code> directory.
</p>
<p>
Next: <a href="resources.html">Struts
Resources</a>
