You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by hu...@apache.org on 2004/07/07 13:12:02 UTC
cvs commit: jakarta-struts/doc/userGuide installation.xml
husted 2004/07/07 04:12:02
Modified: . build-webapp.xml build-webapps.xml
project.properties
doc/userGuide installation.xml
Log:
Conform installation notes with 1.2.x requirements
Revision Changes Path
1.16 +0 -1 jakarta-struts/build-webapp.xml
Index: build-webapp.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/build-webapp.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- build-webapp.xml 10 Aug 2003 06:00:49 -0000 1.15
+++ build-webapp.xml 7 Jul 2004 11:12:02 -0000 1.16
@@ -171,7 +171,6 @@
<pathelement location="${commons-collections.jar}"/>
<pathelement location="${commons-digester.jar}"/>
<pathelement location="${commons-fileupload.jar}"/>
- <pathelement location="${commons-lang.jar}"/>
<pathelement location="${commons-logging.jar}"/>
<pathelement location="${commons-validator.jar}"/>
<pathelement location="${jdbc20ext.jar}"/>
1.29 +1 -1 jakarta-struts/build-webapps.xml
Index: build-webapps.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/build-webapps.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- build-webapps.xml 6 Jul 2004 00:01:08 -0000 1.28
+++ build-webapps.xml 7 Jul 2004 11:12:02 -0000 1.29
@@ -315,7 +315,7 @@
</ant>
<ant antfile="build-webapp.xml" target="dist">
<property name="webapp.name" value="example"/>
- <property name="webapp.war" value="struts-example.war"/>
+ <property name="webapp.war" value="struts-mailreader.war"/>
</ant>
<ant antfile="build-webapp.xml" target="dist">
<property name="webapp.name" value="examples"/>
1.12 +2 -2 jakarta-struts/project.properties
Index: project.properties
===================================================================
RCS file: /home/cvs/jakarta-struts/project.properties,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- project.properties 24 Jun 2004 00:34:56 -0000 1.11
+++ project.properties 7 Jul 2004 11:12:02 -0000 1.12
@@ -23,7 +23,7 @@
# Display the version the web site is documenting
maven.xdoc.version = ${pom.currentVersion}
# Days to report in the change log
-maven.changelog.range=38
+maven.changelog.range=60
compile.debug = on
compile.optimize = off
1.41 +56 -54 jakarta-struts/doc/userGuide/installation.xml
Index: installation.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation.xml,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- installation.xml 4 Jul 2004 23:58:28 -0000 1.40
+++ installation.xml 7 Jul 2004 11:12:02 -0000 1.41
@@ -36,19 +36,19 @@
your operating system platform.
A good starting point for locating Java Development Kit distributions is
<a href="http://java.sun.com/j2se">http://java.sun.com/j2se</a>.
- To build Struts, Java 1.4.2 or later is suggested. </li>
+ To build Struts, Java 1.4.2 (the latest production JDK) is suggested. </li>
<li><strong>Servlet Container</strong> - You <strong>must</strong> download and install a
servlet container that is compatible with the Servlet API Specification,
version 2.2 or later, and the JavaServer Pages (JSP) Specification,
version 1.1 or later. One popular choice is to download Apache's
- <a href="http://jakarta.apache.org/tomcat">Tomcat</a> (version 3.1
- or later required, version 3.3 or later recommended).</li>
+ <a href="http://jakarta.apache.org/tomcat/">Tomcat</a>, but any compliant
+ container should work well with Struts.</li>
<li><strong>XML Parser</strong> - Struts <strong>requires</strong> the presence of an XML
parser that is compatible with the Java API for XML Parsing (JAXP)
specification, 1.1 or later. This is bundled with J2SE 1.4 and later.
- (For earlier versions of Java, the easiest way to obtain JAXP is
+ For earlier versions of Java, the easiest way to obtain JAXP is
probably by downloading the Web Services Developers Kit
(1.1 or later!). See the <a href="http://java.sun.com/xml/jaxp/faq.html#jaxp-ri-latest">
Sun JAXP FAQ</a> for more information.)
@@ -68,7 +68,12 @@
<li>Make sure that the "ant" and "ant.bat" scripts are executable, by
adding the $ANT_HOME/bin directory to your PATH environment
variable.</li>
- </ul></li>
+ </ul>
+ <a href="http://maven.apache.org/">Maven</a> property files are also
+ provided, but the Maven build is still experimental. New developers
+ may find Maven easier to use, since it acquires the appropriate JARs
+ automatically.
+ </li>
<li><strong>Servlet API Classes</strong> - In order to compile Struts itself,
or applications that use Struts, you will need a <code>servlet.jar</code>
@@ -90,18 +95,18 @@
These are the packages which must be available if you wish to
build Struts from source:
<ul>
- <li><em>ANTLR</em> (Version 2.7.2 or later)</li>
- <li><em>Commons Beanutils</em> (Version 1.6.1 or later)</li>
- <li><em>Commons Collections</em> (Version 2.1 or later)</li>
- <li><em>Commons Digester</em> (Version 1.5 or later)</li>
- <li><em>Commons FileUpload</em> (Version 1.0 or later)</li>
- <li><em>Commons Lang</em> (Version 2.0 or later)</li>
- <li><em>Commons Logging</em> (Version 1.0.3 or later when it is available)</li>
- <li><em>Commons Validator</em> (Version 1.1.3 or later) </li>
- <li><em>Jakarta ORO</em> (Version 2.0.7 or later)</li>
+ <li><a href="http://www.antlr.org/">ANTLR</a> (Version 2.7.2)</li>
+ <li><a href="http://jakarta.apache.org/commons/beanutils/">Commons Beanutils</a> (Version 1.6.1)</li>
+ <li><a href="http://jakarta.apache.org/commons/collections/">Commons Collections</a> (Version 2.1)</li>
+ <li><a href="http://jakarta.apache.org/commons/digester/">Commons Digester</a> (Version 1.5)</li>
+ <li><a href="http://jakarta.apache.org/commons/fileupload/">Commons FileUpload</a> (Version 1.0)</li>
+ <li><a href="http://jakarta.apache.org/commons/logging/">Commons Logging</a> (Version 1.0.4)</li>
+ <li><a href="http://jakarta.apache.org/commons/validator/">Commons Validator</a> (Version 1.1.3) </li>
+ <li><a href="http://jakarta.apache.org/oro/">Jakarta ORO</a> (Version 2.0.7 or later)</li>
</ul>
- ANTLR is a public domain library; all other libraries are distributed under the
- Apache Software License.
+ ANTLR is a <a href="http://antlr.org/license.html">public domain library</a>;
+ all other libraries are distributed under the
+ <a href="http://www.apache.org/licenses/">Apache Software License</a>.
For your convenience, the requisite JARs are provided as a single
download under the <code>lib</code> sub-directory with each release
distribution.
@@ -142,24 +147,24 @@
for you). The 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/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.
+ <li><strong>lib/*.jar</strong> - The struts.jar contains the Java classes
+ distributed by the Struts project. The other JAR files contain packages
+ from other projects that are imported by Struts. When you launch
+ a Struts-based application, these JARs need to be available to your
+ application, usually by copying them to the application's
+ <code>WEB-INF/lib</code> directory. <br />
<em>WARNING</em> - If you are going to be hosting multiple Struts
based applications on the same servlet container, you will be tempted
to place the <code>struts.jar</code> file into the shared repository
- supported by your container. Be advised that this will like cause you
- to encounter ClassNotFoundException problems unless <em>all</em> of
+ supported by your container. Be advised that this may cause
+ 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/*.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. (Servlet 2.3 can omit this step
- if the <a href="configuration.html#dd_config_taglib_23">standard uri</a>
+ tag libraries. The tld file for any Struts taglibs that you use should
+ be copied into the <code>WEB-INF</code> directory of your web
+ application. (Applications under Servlet 2.3 containers can omit this
+ step if the <a href="configuration.html#dd_config_taglib_23">standard uri</a>
is referenced.)</li>
<li><strong>webapps/struts-blank.war</strong> - This is a simple "web
application archive" file containing a basic starting point for
@@ -167,42 +172,40 @@
<li><strong>webapps/struts-documentation.war</strong> - This is a
"web application archive" file containing all of the Struts
documentation found on the
- <a href="http://jakarta.apache.org/struts">Struts web site</a>
+ <a href="http://struts.apache.org/">Struts web site</a>
(including these pages). You can install this web application
on any servlet container compatible with Servlet API 2.2 or later.</li>
- <li><strong>webapps/struts-example.war</strong> - This is an example
+ <li><strong>webapps/struts-examples.war</strong> - This "modular"
+ applications combines several usefule demonstrations:
+ <ul><li>Exercise-Taglib - This application module contains test pages for
+ the various custom tags distributed with Struts. It is primarily of use to
+ developers who are enhancing the Struts custom tag libraries, but may also
+ be useful as simple examples of the usage of various Struts tags.</li>
+ <li><strong>Upload</strong> - This application module
+ is a quick example of uploading files using the Struts framework.
+ </li>
+ <li><strong>Validator</strong> - This application module
+ is an example of using the validator framework, using both the
+ server-side and optional client-side validation.
+ </li></ul></li>
+ <li><strong>webapps/struts-mailreader.war</strong> - This is an example
web application that uses a large percentage of Struts features.
You can install this web application on any servlet container
compatible with the Servlet 2.2 (or later) and JSP 1.1 (or later)
specifications. If an XML parser is not made available to web
applications by your container, you will need to add one to the
WEB-INF/lib directory of this web application.</li>
- <li><strong>webapps/struts-exercise-taglib.war</strong> - This web
- application contains test pages for the various custom tags supported
- by Struts. It is primarily of use to developers who are enhancing the
- Struts custom tag libraries, but may also be useful as simple examples
- of the usage of various Struts tags.</li>
- <li><strong>webapps/struts-upload.war</strong> - This web application
- is a quick example of uploading files using the Struts framework.
- </li>
- <li><strong>webapps/struts-validator.war</strong> - This web application
- is an example of using the validator framework, using both the
- server-side and optional client-side validation.
- </li>
- <li><strong>webapps/tiles-documentation.war</strong> - This web
+ <li><strong>webapps/tiles-documentation.war</strong> - This web
application documents how to use tiles, and was developed using tiles.</li>
</ul>
<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
+ <li>Copy the <code>lib/*.jar</code> files 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 <code>lib/*.tld</code> files for any Struts taglibs you use
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
@@ -243,15 +246,14 @@
this particular page, like this:</li>
</ul>
-<pre><%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
-<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
-<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>
+<pre><%@ taglib uri="/tags/struts-bean" prefix="bean" %>
+<%@ taglib uri="/tags/struts-html" prefix="html" %>
+<%@ taglib uri="/tags/struts-logic" prefix="logic" %>
</pre>
<ul>
<li>When compiling the Java classes that comprise your application, be sure
- to include the <code>struts.jar</code> and
- <code>commons-*.jar</code> files (copied earlier) on the
+ to include the JAR 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">
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org