husted 2002/08/31 06:15:04
Modified: doc/userGuide struts-html.xml release-notes.xml preface.xml
installation.xml installation-wls5.xml
installation-was352.xml installation-was352-x.xml
installation-ubs72.xml installation-tc.xml
installation-sas.xml installation-oas.xml
installation-jr30.xml installation-jetty.xml
installation-ipas.xml installation-ip.xml index.xml
dev_validator.xml dev_util.xml dev_tiles.xml
dev_template.xml dev_nested.xml dev_logic.xml
dev_html.xml dev_bean.xml
Log:
Technical changes to accomodate listing authors at the top of each chapter.
Revision Changes Path
1.24 +1 -0 jakarta-struts/doc/userGuide/struts-html.xml
Index: struts-html.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/struts-html.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- struts-html.xml 24 Aug 2002 22:01:30 -0000 1.23
+++ struts-html.xml 31 Aug 2002 13:15:02 -0000 1.24
@@ -2,6 +2,7 @@
<document url="./struts-html.xml">
<properties>
+ <author>Craig R. McClanahan</author>
<author>Martin Cooper</author>
<author>Mike Schachter</author>
<title>The Struts Framework Project - HTML Tags</title>
1.12 +2 -1 jakarta-struts/doc/userGuide/release-notes.xml
Index: release-notes.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/release-notes.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- release-notes.xml 14 Aug 2002 15:17:39 -0000 1.11
+++ release-notes.xml 31 Aug 2002 13:15:02 -0000 1.12
@@ -11,6 +11,7 @@
<body>
+ <chapter name="5.1 Release Notes" href="release_notoes">
<section name="Beta Notes" href="beta">
<p>This section contains the release notes for
@@ -592,7 +593,7 @@
<p>Next: <a href="installation.html">Installation</a></p>
</section>
-
+</chapter>
</body>
</document>
1.8 +1 -0 jakarta-struts/doc/userGuide/preface.xml
Index: preface.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/preface.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- preface.xml 14 Aug 2002 15:17:39 -0000 1.7
+++ preface.xml 31 Aug 2002 13:15:02 -0000 1.8
@@ -4,6 +4,7 @@
<properties>
<author>Ted Husted</author>
<author>Ed Burns</author>
+ <author>Craig R. McClanahan</author>
<title>The Struts User's Guide - Preface: Core Technologies</title>
</properties>
1.6 +30 -17 jakarta-struts/doc/userGuide/installation.xml
Index: installation.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- installation.xml 13 Aug 2002 16:28:49 -0000 1.5
+++ installation.xml 31 Aug 2002 13:15:02 -0000 1.6
@@ -3,18 +3,29 @@
<properties>
<author>Craig R. McClanahan</author>
- <author>Martin Cooper</author>
+ <author>Mike Schachter</author>
<author>Ted Husted</author>
+ <author>Martin Cooper</author>
+ <author>Chris Assenza</author>
+ <author>dIon Gillard</author>
+ <author>Eric Wu</author>
+ <author>John Rousseau</author>
+ <author>John Ueltzhoeffer</author>
+ <author>Mark Budai</author>
+ <author>Paul Runyan</author>
+ <author>Robert Hayden</author>
+ <author>Stanley Santiago</author>
+ <author>Wong Kok Kai</author>
<title>The Struts Framework Project - Installation (1.1)</title>
</properties>
<body>
-
+ <chapter name="5.2 Installation" href="installation">
<section name="Prerequisite Software" href="Prerequisites">
- <p>The Struts binary distribution needs three other software packages installed
to
- operate. You may already have these installed on your system. To build Struts
from
- source you may need to acquire and install several others. The complete list is
as
+ <p>The Struts binary distribution needs three other software packages installed to
+ operate. You may already have these installed on your system. To build Struts from
+ source you may need to acquire and install several others. The complete list is as
follows:</p>
<ul>
@@ -98,8 +109,8 @@
above.</p>
<p>Unpack the Struts binary distribution into a convenient directory.
- (If you <a href="#Building">build Struts from the source distribution</a>,
- the result of the build will already be an unpacked binary distribution
+ (If you <a href="#Building">build Struts from the source distribution</a>,
+ the result of the build will already be an unpacked binary distribution
for you). The distribution consists of the following contents:</p>
<ul>
@@ -146,7 +157,7 @@
Struts custom tag libraries, but may also be useful as simple examples
of the usage of various Struts tags.</li>
<li><strong>webapps/struts-template.war</strong> - This web application
- both introduces and demonstrates the Struts template tags.</li>
+ both introduces and demonstrates the Struts template tags.</li>
<li><strong>webapps/struts-upload.war</strong> - This web application
is a quick example of uploading files using the Struts framework.</li>
</ul>
@@ -216,11 +227,11 @@
<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">
+</section> <section name="Installing Struts With Your Servlet Container"
href="Containers">
<p>For most containers, you need only to: </p>
<ul>
- <li>Copy the WAR files in your Struts <code>/webapp</code> directory to your
+ <li>Copy the WAR files in your Struts <code>/webapp</code> directory to your
containers <code>webapps</code> directory. </li>
<li>In some cases, you may need to restart your container if it is running.</li>
</ul>
@@ -241,23 +252,23 @@
<h3>Installing Struts on Various Containers</h3>
<ul>
- <li>Bluestone Universal Business Server - <a
href="installation-ubs.html">Additional
+ <li>Bluestone Universal Business Server 7.2 - <a
href="installation-ubs72.html">Additional
steps required.</a></li>
- <li>Borland Application Server 4.5 -No additional
+ <li>Borland Application Server 4.5 -No additional
steps required.</li>
- <li>iPlanet Application Server - Service Pack 2 is recommended. Note that the
database
+ <li>iPlanet Application Server - Service Pack 2 is recommended. Note that the
database
object in the Struts-Example application is not compatible with this
container.</li>
<li>iPlanet Web Server - <a href="installation-ip.html">Additional steps
required.</a></li>
<li>iPortal Application Server - <a href="installation-ipas.html">Additional
steps required.</a></li>
<li>Jetty - <a href="installation-jetty.html">Additional steps required.</a></li>
<li>JRun - <a href="installation-jr30.html">Additional steps required.</a></li>
- <li>Orion Application Server - <a href="installation-oas.html">Additional steps
+ <li>Orion Application Server - <a href="installation-oas.html">Additional steps
required.</a></li>
<li>Resin 1.2+ "standalone" - No additional steps required.</li>
<li>RexIP - No additional steps required.</li>
<li>SilverStream 3.7.1 and later - <a href="installation-sas.html">Additional
steps required.</a></li>
<li>Tomcat 3.1 and prior - Not recommended. Use Tomcat 3.2.1 or later.</li>
- <li>Tomcat 3.2.1 with Apache - <a href="installation-tc.html">Additional steps
+ <li>Tomcat 3.2.1 with Apache - <a href="installation-tc.html">Additional steps
required.</a></li>
<li>Tomcat 3.2.1+ "standalone" - No additional steps required.</li>
<li>Tomcat 4.0 - No additional steps required.</li>
@@ -265,7 +276,7 @@
<li>WebLogic 6.0+ - No additional steps required.</li>
<li>WebSphere - <a href="installation-was352.html">Additional steps
required.</a></li>
<li>WebSphere - <a href="installation-was352-x.html">Steps for the Example
Application.</a></li></ul>
-</section>
+</section>
<section name="Building Struts From Source" href="Building">
@@ -328,7 +339,7 @@
in the <a href="Installing">preceding section</a>.</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
+ 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
@@ -337,9 +348,11 @@
</section>
+
<p>
Next: <a href="../newbie.html">Newbie FAQ</a>
</p>
+ </chapter>
</body>
</document>
1.2 +46 -45 jakarta-struts/doc/userGuide/installation-wls5.xml
Index: installation-wls5.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-wls5.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-wls5.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-wls5.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -8,46 +8,46 @@
</properties>
<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="wls5">Weblogic 5.1 (service pack 8)</a></h3>
<ul>
- <li>Obtain and install the Xerces XML parser (problems have been reported with
- the Sun reference implementation). Put xerces.jar in your WebLogic system
+ <li>Obtain and install the Xerces XML parser (problems have been reported with
+ the Sun reference implementation). Put xerces.jar in your WebLogic system
path.</li>
- <li>Obtain and unpack the Struts binary distribution (this procedure assumes
+ <li>Obtain and unpack the Struts binary distribution (this procedure assumes
it was extracted to <code>c:\jakarta-struts</code>).</li>
- <li>Add an entry to weblogic.properties for each of the Struts web applications
- that you would like to configure. For example, to make the struts-example
+ <li>Add an entry to weblogic.properties for each of the Struts web applications
+ that you would like to configure. For example, to make the struts-example
application available, add the following line to weblogic.properties:<br/>
<code>weblogic.httpd.webApp.strutsexample=<br/>
c:/jakarta-struts/webapps/struts-example.war</code></li>
- <li>You do not need to include struts.jar or any of the application specific
- classes in the WebLogic classpath, since this will be done automatically
(unless
+ <li>You do not need to include struts.jar or any of the application specific
+ classes in the WebLogic classpath, since this will be done automatically (unless
deploying an unpacked web archive- see below).</li>
- <li>Start WebLogic server and point your web browser to the struts application.
+ <li>Start WebLogic server and point your web browser to the struts application.
For example, to connect to the example application added in step 3:<br/>
<code>http://localhost:7001/strutsexample</code></li>
- <li>This example application depends on the Struts specific resource file
ApplicationResources.properties
- to be present on the classpath. However, WebLogic only extracts *.class files
- from the archive so this file will not be found, resulting in an error the
- first time it is needed- something similar to: javax.servlet.ServletException:
- runtime failure in custom tag 'message'. Steps 6 & 7 will need to be
performed
+ <li>This example application depends on the Struts specific resource file
ApplicationResources.properties
+ to be present on the classpath. However, WebLogic only extracts *.class files
+ from the archive so this file will not be found, resulting in an error the
+ first time it is needed- something similar to: javax.servlet.ServletException:
+ runtime failure in custom tag 'message'. Steps 6 & 7 will need to be
performed
for this application, and any other that relies on
ApplicationResources.properties.</li>
- <li>Extract ApplicationResources.properties from the *.war file, and manually
- copy it to the respective package in the _tmp_war_ directory WebLogic created
- for this application. Again referring to the struts-example application, this
+ <li>Extract ApplicationResources.properties from the *.war file, and manually
+ copy it to the respective package in the _tmp_war_ directory WebLogic created
+ for this application. Again referring to the struts-example application, this
would be:<br/>
<code>c:\jakarta-struts\webapps\WEB-INF\_tmp_war_strutsexample</code></li>
<li>Restart WebLogic. You will now be able to run the application:<br/>
<code>http://localhost:7001/strutsexample</code></li>
</ul>
-<p>The above steps should be followed for applications deployed as *.war files.
- For unpacked web applications, configuration involves adding both
<code>struts.jar</code>
- and <code>/WEB-INF/classes</code> to the WebLogic classpath. For this reason,
- I would suggest deploying applications as war files to WebLogic. However, the
- same example application can be successfully deployed in extracted format by
+<p>The above steps should be followed for applications deployed as *.war files.
+ For unpacked web applications, configuration involves adding both
<code>struts.jar</code>
+ and <code>/WEB-INF/classes</code> to the WebLogic classpath. For this reason,
+ I would suggest deploying applications as war files to WebLogic. However, the
+ same example application can be successfully deployed in extracted format by
modifying weblogic.properties (assuming the war was extracted to directory
webapps/struts-example):</p>
<p><code>weblogic.httpd.webApp.strutsexample=<br/>
c:/jakarta-struts/webapps/struts-example/</code></p>
@@ -57,21 +57,21 @@
<hr/>
<h4>Additional Recommendations</h4>
<ul>
- <li>Servlet and JSP-Reloading should be turned off. First, you pay a performance
- penalty. Depending on the number of JSPs, the number of requests and the
- configured checking interval, the server will slow down. Second, with JSP- and
- Servlet reloading, one opens the door for various Weblogic classloader
problems,
- that are difficult to diagnose, difficult to handle and often lead to lost
- HTTP-sessions.</li>
- <li>Set the name of the <code>sessionid</code> to <code>JSESSIONID</code>, if
cookies are used for session
- tracking and to jsessionid, if sessions are URL-based. (There are additional
- problems related to URL-based sessions, caused from BEA's way to encode the
session
- id (J2EE-incompatible) as query-param. Especially <bean:include> will
not work with
- URL-based sessions yet. However, using the correct session name solves at
least some
- problems.)</li>
- <li>Configure the JSP-Servlet registration in <code>weblogic.properties</code>
for
+ <li>Servlet and JSP-Reloading should be turned off. First, you pay a performance
+ penalty. Depending on the number of JSPs, the number of requests and the
+ configured checking interval, the server will slow down. Second, with JSP- and
+ Servlet reloading, one opens the door for various Weblogic classloader problems,
+ that are difficult to diagnose, difficult to handle and often lead to lost
+ HTTP-sessions.</li>
+ <li>Set the name of the <code>sessionid</code> to <code>JSESSIONID</code>, if
cookies are used for session
+ tracking and to jsessionid, if sessions are URL-based. (There are additional
+ problems related to URL-based sessions, caused from BEA's way to encode the
session
+ id (J2EE-incompatible) as query-param. Especially <bean:include> will not
work with
+ URL-based sessions yet. However, using the correct session name solves at least
some
+ problems.)</li>
+ <li>Configure the JSP-Servlet registration in <code>weblogic.properties</code> for
maximum J2EE-compliance and/or for maximum performance.</li></ul>
- <p>The JSP-Servlet supports some initialization parameters that can be customized
to get
+ <p>The JSP-Servlet supports some initialization parameters that can be customized
to get
best performance, maximum compliance or (as shown below) easier debugging:</p>
<pre>
weblogic.httpd.initArgs.*.jsp=\
@@ -83,16 +83,16 @@
debug=true,\
verbose=true
</pre>
-<p>In the above example, the batch file (<code>_jspCompiler_.cmd</code>) invokes
jikes
- which results dramatically reduced startup times (jikes is about three times
faster
+<p>In the above example, the batch file (<code>_jspCompiler_.cmd</code>) invokes
jikes
+ which results dramatically reduced startup times (jikes is about three times
faster
than javac.) The batchfile contains only a single line:</p>
<pre>@jikes -g -nowarn %*</pre>
-<p>The next configuration could be used when all tests have been done and speed is
the
+<p>The next configuration could be used when all tests have been done and speed is
the
major concern ...</p>
-<pre>
+<pre>
weblogic.httpd.initArgs.*.jsp=\
pageCheckSeconds=-1,\
setEmptyStrings=false,\
@@ -109,17 +109,18 @@
<p>Weblogic supports similar settings through <code><context-params></code>
in <code>web.xml</code>
(Please read the latest documentation at the BEA website for details.)</p>
-<p>For additional issues, see also <a
-href="http://www.mail-archive.com/struts-dev@jakarta.apache.org/msg00284.html";>More
+<p>For additional issues, see also <a
+href="http://www.mail-archive.com/struts-dev@jakarta.apache.org/msg00284.html";>More
fixes for WLS 5.1 SP8</a> from the Struts Developer mailing list</p>
-<hr/>
+<hr/>
<ul>
<li>Author: Robert Hayden</li>
<li>Author: Wong Kok Kai</li>
<li>Author: Matthias Kerkhoff </li>
</ul>
- <hr/>
+ <hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
</section>
+</chapter>
</body>
</document>
1.2 +47 -46 jakarta-struts/doc/userGuide/installation-was352.xml
Index: installation-was352.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-was352.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-was352.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-was352.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -7,81 +7,81 @@
</properties>
<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="was352">WebSphere Application Server 3.5 FixPack 2</a></h3>
<ul>
<li>In the steps below, <code>$WAS_HOME</code> refers to the directory in which you
- have installed WebSphere Application Server, and <code>$STRUTS_HOME</code> is the
+ have installed WebSphere Application Server, and <code>$STRUTS_HOME</code> is the
directory in which you unpacked the Struts binary distribution.</li>
-<li>WebSphere before 3.5.2 did not support JSP 1.1 and Servlet 2.2, which
- made it difficult to get Struts functioning without massive code changes.
- Please upgrade to 3.5.2 (3.5 with FixPack 2) before attempting to use
+<li>WebSphere before 3.5.2 did not support JSP 1.1 and Servlet 2.2, which
+ made it difficult to get Struts functioning without massive code changes.
+ Please upgrade to 3.5.2 (3.5 with FixPack 2) before attempting to use
Struts. See <a
href="http://www.ibm.com/software/webservers/appserv/efix.html";>http://www.ibm.com/software/webservers/appserv/efix.html</a>
for download and install instructions on FixPack 2 for WebSphere 3.5</li>
-
-<li>Warning: Struts will not work with WebSphere 3.5.2 out of the box. Fixes
- expected to be in WebSphere 3.5.3 (not released at time of writing) should
- correct this. However, you can successfully get WebSphere 3.5.2 working
+
+<li>Warning: Struts will not work with WebSphere 3.5.2 out of the box. Fixes
+ expected to be in WebSphere 3.5.3 (not released at time of writing) should
+ correct this. However, you can successfully get WebSphere 3.5.2 working
with Struts.</li>
-
-<li>Make sure the WebSphere Application Server is started. Under Windows
+
+<li>Make sure the WebSphere Application Server is started. Under Windows
NT/2000, it's the "IBM WS AdminServer" service.</li>
-
+
<li>Start the WebSphere Administrative Console.</li>
-<li>Once it's started, select "Convert a War File" from the tasks toolbar
- option, or from the Console->Tasks menu. This will cause a "Convert War
+<li>Once it's started, select "Convert a War File" from the tasks toolbar
+ option, or from the Console->Tasks menu. This will cause a "Convert War
File" Wizard dialog to appear.</li>
-
-<li>Select a Servlet Engine to host the web application that will result
- from converting the War file, e.g. "Default Servlet Engine", by expanding
+
+<li>Select a Servlet Engine to host the web application that will result
+ from converting the War file, e.g. "Default Servlet Engine", by expanding
the tree control under Nodes. Press the Next button.</li>
-
-<li>Select a Virtual Host to associate the resulting web application with,
+
+<li>Select a Virtual Host to associate the resulting web application with,
e.g. "default host". Press the Next button.</li>
-
-<li>Press the Browse button and choose the
+
+<li>Press the Browse button and choose the
<code>$STRUTS_HOME/webapps/struts-example.war</code>. Press the Next button</li>
-
+
<li>Select a destination directory for the resulting web application, e.g.
<code>$WAS_HOME/hosts/default_host</code>. Press the Next button</li>
-<li>Enter a "Web Application Web Path", e.g. struts-example, and a "Web
+<li>Enter a "Web Application Web Path", e.g. struts-example, and a "Web
Application Name", e.g. struts-example. Press the Finish button.</li>
-
+
<li>You should, after a lengthy pause, get a message box with the text
Command "convert war file" completed successfully. Press Ok.</li>
-
-<li>You now need to add jaxp.jar and a jaxp compatible parser, e.g.
- parser.jar from JAXP 1.0.1 to the struts-example web application's
+
+<li>You now need to add jaxp.jar and a jaxp compatible parser, e.g.
+ parser.jar from JAXP 1.0.1 to the struts-example web application's
servlets directory, e.g.
<code>$WAS_HOME/AppServer/hosts/default_host/struts-example/servlets</code></li>
-
-<li>At this point, if WAS 3.5.2 correctly implemented Servlet 2.2, all
- would be fine. However, WAS 3.5.2 returns null for calls to
- <code>ServletContext.getResource(String)</code> or
- <code>ServletContext.getResourceAsStream(String)</code>. This manifests itself as
an
- exception in the application server stdout log, e.g.
+
+<li>At this point, if WAS 3.5.2 correctly implemented Servlet 2.2, all
+ would be fine. However, WAS 3.5.2 returns null for calls to
+ <code>ServletContext.getResource(String)</code> or
+ <code>ServletContext.getResourceAsStream(String)</code>. This manifests itself as
an
+ exception in the application server stdout log, e.g.
<code>default_server_stdout.log.</code></li>
-
-<li>Warning: Don't be fooled by the fact that the web application starts
- successfully from the Admin Console. It actually doesn't. The Admin
+
+<li>Warning: Don't be fooled by the fact that the web application starts
+ successfully from the Admin Console. It actually doesn't. The Admin
Console is lying. If you try to access the webapp
e.g. <code>http://localhost/struts-example/</code> it will fail.</li>
-
-<li>At this point, you need to patch the Struts source. There are three
+
+<li>At this point, you need to patch the Struts source. There are three
places <code>getResourceAsStream</code> is called:</li></ul>
<pre>
ResourceTag.doStartTag()
ActionServlet.initMapping()
PropertyMessageResources.loadLocale(String)
-</pre>
+</pre>
<p>of these, <code>ActionServlet</code> is the most important.</p>
-
+
<ul><li>Change the source from</li></ul>
<pre>
// Acquire an input stream to our configuration resource
@@ -90,17 +90,17 @@
<p>to</p>
<pre>
// Acquire an input stream to our configuration resource
- InputStream input = new
+ InputStream input = new
java.io.FileInputStream(getServletContext().getRealPath(config));
</pre>
<ul><li> Make similar changes to the other classes if necessary.</li>
-
+
<li>Recompile ActionServlet and copy the <code>.class</code> file to <br/>
<code>$WAS_HOME/AppServer/hosts/default_host/struts-example/servlets/<br/>
org/apache/struts/action/ActionServlet.class</code></li>
-<li>Another bug with WAS 3.5.2's classloaders is that Class.getResource()
+<li>Another bug with WAS 3.5.2's classloaders is that Class.getResource()
wont load a resource from a jar, so you must copy<br/>
<code>$STRUTS_HOME/lib/struts-config_1_0.dtd</code> <br/>
to <br/>
@@ -109,13 +109,14 @@
<li>Start your webapp in the Admin Console</li>
-<li>Test the example application by loading the following URL in your
+<li>Test the example application by loading the following URL in your
browser of choice: <a
href="http://localhost/struts-example/";>http://localhost/struts-example/";
>http://localhost/struts-example/</a></li>
-</ul>
+</ul>
<hr/>
<ul><li>Author: dIon Gillard</li></ul>
<hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
</section>
+</chapter>
</body>
</document>
1.2 +3 -4 jakarta-struts/doc/userGuide/installation-was352-x.xml
Index: installation-was352-x.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-was352-x.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-was352-x.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-was352-x.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -7,8 +7,8 @@
</properties>
<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="was352">WebSphere Application Server 3.5 and the Example
Application</a></h3>
@@ -75,9 +75,8 @@
<p>If changing the DTD's to SYSTEM, do so ONLY AFTER using the Convert a War
util. Ant doesn't seem to like it the other way! :)</p>
<hr/>
- <ul><li>Author: Chris Assenza</li></ul>
- <hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
</section>
+</chapter>
</body>
</document>
1.2 +19 -19 jakarta-struts/doc/userGuide/installation-ubs72.xml
Index: installation-ubs72.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-ubs72.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-ubs72.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-ubs72.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -7,20 +7,19 @@
</properties>
<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
-
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="bluestone">Bluestone Universal Business Server 7.2</a></h3>
<ul>
- <li>You need UBS version 7.2 to run war file applications. The UBS 7.2.2
evaluation
- is located <a
href="http://www.bluestone.com/SaISAPI.dll/SaServletEngine.class/products/downloads.jsp";>here</a>.
- If you're using version 7.2.1, you need to download the WAR file patch, located
- in the product enhancement section of Bluestone's website <a
href="http://www.bluestone.com/SaISAPI.dll/SaServletEngine.class/products/wfe.jsp";>here</a>
+ <li>You need UBS version 7.2 to run war file applications. The UBS 7.2.2
evaluation
+ is located <a
href="http://www.bluestone.com/SaISAPI.dll/SaServletEngine.class/products/downloads.jsp";>here</a>.
+ If you're using version 7.2.1, you need to download the WAR file patch, located
+ in the product enhancement section of Bluestone's website <a
href="http://www.bluestone.com/SaISAPI.dll/SaServletEngine.class/products/wfe.jsp";>here</a>
</li>
- <li> After installation of the correct version and/or patch of UBS 7.2, you
- need to modify your apserver.txt file to point to the correct directory for
- your war file applications. Look for the section that says something similar
+ <li> After installation of the correct version and/or patch of UBS 7.2, you
+ need to modify your apserver.txt file to point to the correct directory for
+ your war file applications. Look for the section that says something similar
to the following:<br />
<pre>
[SaServletEngine.class]
@@ -32,19 +31,19 @@
</pre>
</li>
- <li>Use the directory specified by the "file_path" variable, or modify it to
- point to your own custom webapp directory. Copy the "struts-documention.war"
- and "struts-example.war" files into that webapp directory, and start the UBS
- (read documentation distributed with UBS for information on how to start it
- if necessary). Your webapps are now accessible from the following URL:
+ <li>Use the directory specified by the "file_path" variable, or modify it to
+ point to your own custom webapp directory. Copy the "struts-documention.war"
+ and "struts-example.war" files into that webapp directory, and start the UBS
+ (read documentation distributed with UBS for information on how to start it
+ if necessary). Your webapps are now accessible from the following URL:
<p align="center">
http://localhost/<PLUGIN>/SaServletEngine.class/struts-example/<br />
- http://localhost/<PLUGIN>/SaServletEngine.class/struts-documentation/
+ http://localhost/<PLUGIN>/SaServletEngine.class/struts-documentation/
</p>
</li>
- <li> Note: "<PLUGIN>" represents the plugin you are using for your specific
- webserver. For apache on Windows, it might be "cgi-bin/SaCGI.exe", for IIS
- on Windows, it might be "scripts/SaCGI.exe" or "scripts/ISAPI.dll". Consult
+ <li> Note: "<PLUGIN>" represents the plugin you are using for your specific
+ webserver. For apache on Windows, it might be "cgi-bin/SaCGI.exe", for IIS
+ on Windows, it might be "scripts/SaCGI.exe" or "scripts/ISAPI.dll". Consult
the UBS documentation for more information. </li>
</ul>
<hr/>
@@ -54,5 +53,6 @@
<hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
</section>
+</chapter>
</body>
</document>
1.2 +22 -21 jakarta-struts/doc/userGuide/installation-tc.xml
Index: installation-tc.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-tc.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-tc.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-tc.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -7,25 +7,25 @@
</properties>
<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="tc321">Tomcat 3.2.1 With Apache</a></h3>
-<p>Note that the instructions for Tomcat 4 will be different than those for Tomcat
3,
-but the Tomcat 4.0 web connector is still under development. Versions of Tomcat
prior
+<p>Note that the instructions for Tomcat 4 will be different than those for Tomcat
3,
+but the Tomcat 4.0 web connector is still under development. Versions of Tomcat
prior
to 3.2.1 are not recommend for use with Struts.</p>
<ul>
- <li>These instructions assume you have successfully integrated Tomcat with Apache
+ <li>These instructions assume you have successfully integrated Tomcat with Apache
according to the Tomcat documentation.</li>
- <li>Copy "struts-documentation.war" and "struts-example.war" to your
$TOMCAT_HOME/webapps
+ <li>Copy "struts-documentation.war" and "struts-example.war" to your
$TOMCAT_HOME/webapps
directory</li>
<li>Restart Tomcat if it is already running</li>
- <li>Tomcat will generate a file "$TOMCAT_HOME/conf/tomcat-apache.conf" that
- will be used by Apache. This file is regenerated every time you start Tomcat,
- so copy this file to a safe place (such as your Apache configuration directory;
+ <li>Tomcat will generate a file "$TOMCAT_HOME/conf/tomcat-apache.conf" that
+ will be used by Apache. This file is regenerated every time you start Tomcat,
+ so copy this file to a safe place (such as your Apache configuration directory;
on Unix systems this is usually <code>/usr/local/apache/conf</code>.</li>
- <li>If you are running Tomcat 3.1, Tomcat will not have generated the entries
- for your new applications. Add the following lines to the
<code>tomcat-apache.conf</code>
- file that you have saved, replacing $TOMCAT_HOME with the path to your Tomcat
+ <li>If you are running Tomcat 3.1, Tomcat will not have generated the entries
+ for your new applications. Add the following lines to the
<code>tomcat-apache.conf</code>
+ file that you have saved, replacing $TOMCAT_HOME with the path to your Tomcat
home directory:</li>
</ul>
<pre>
@@ -49,23 +49,23 @@
</Location>
</pre>
<ul>
- <li>The generated file above does not know anything
- about extension mappings defined in a web.xml file, so the "*.do" URIs that
- go to the controller servlet will not be recognized. To fix this, add the
- following line to the saved version of "tomcat-apache.conf", after the
corresponding
+ <li>The generated file above does not know anything
+ about extension mappings defined in a web.xml file, so the "*.do" URIs that
+ go to the controller servlet will not be recognized. To fix this, add the
+ following line to the saved version of "tomcat-apache.conf", after the
corresponding
line for the .jsp extension:<br/>
<code>AddHandler jserv-servlet .do</code></li>
- <li>Ensure that the saved version of "tomcat-apache.conf" is referenced in your
- Apache "httpd.conf" configuration file. A typical use would have the following
+ <li>Ensure that the saved version of "tomcat-apache.conf" is referenced in your
+ Apache "httpd.conf" configuration file. A typical use would have the following
line at the bottom of "httpd.conf":<br/>
<code>Include /usr/local/apache/conf/tomcat-apache.conf</code></li>
- <li>In order to recognize "index.jsp" as a default page for web applications,
- search in your "httpd.conf" for a "DirectoryIndex" directive. If you have
+ <li>In order to recognize "index.jsp" as a default page for web applications,
+ search in your "httpd.conf" for a "DirectoryIndex" directive. If you have
one, add "index.jsp" to the end of the list, so that it might look like
this:<br/>
<code>DirectoryIndex index.html index.jsp</code><br/>
If you do not have such an entry, add one like this:<br/>
<code>DirectoryIndex index.jsp</code></li>
- <li>Restart Apache to make it aware of the new applications. You should now
+ <li>Restart Apache to make it aware of the new applications. You should now
be able to access the applications from a browser like this:<br/>
<code>http://localhost/struts-documentation<br/>
http://localhost/struts-example</code></li>
@@ -75,5 +75,6 @@
<hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
</section>
+</chapter>
</body>
</document>
1.2 +8 -7 jakarta-struts/doc/userGuide/installation-sas.xml
Index: installation-sas.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-sas.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-sas.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-sas.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -7,15 +7,15 @@
</properties>
<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="sas">SilverStream Application Server 3.7.1 and later</a></h3>
<ul>
<li>Start the SilverStream application server.</li>
- <li>Create an XML deployment plan for the
"<code>struts-example.war</code>"
- application. Call the file
"<code>struts-example-depl-plan.xml</code>".
+ <li>Create an XML deployment plan for the
"<code>struts-example.war</code>"
+ application. Call the file
"<code>struts-example-depl-plan.xml</code>".
You can use the following contents for the file</li>
</ul>
@@ -41,8 +41,8 @@
<hr/>
-<p>Create an XML deployment plan for the
"<code>struts-documentation.war</code>"
- application. Call the file "struts-documentation-depl-plan.xml".
+<p>Create an XML deployment plan for the
"<code>struts-documentation.war</code>"
+ application. Call the file "struts-documentation-depl-plan.xml".
You can use the following contents for the file:</p>
<hr/>
@@ -65,7 +65,7 @@
<p>----- cut here -----</p>
<hr/>
-<p>Run the following "<code>SilverCmd DeployWAR</code>" commands to
+<p>Run the following "<code>SilverCmd DeployWAR</code>" commands to
deploy the applications. You can change 'localhost' to whatever server you
are deploying to. You can change 'Silvermaster' to whatever
database you are deploying to.</p>
@@ -78,5 +78,6 @@
<hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
</section>
+</chapter>
</body>
</document>
1.2 +24 -23 jakarta-struts/doc/userGuide/installation-oas.xml
Index: installation-oas.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-oas.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-oas.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-oas.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -6,18 +6,18 @@
</properties>
<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h4><a name="orion">Orion Application Server</a></h4>
-<p>In the steps below, <code>$ORION_HOME</code> refers to the directory in which
- you have installed Orion, and <code>$STRUTS_HOME</code> is the directory in
+<p>In the steps below, <code>$ORION_HOME</code> refers to the directory in which
+ you have installed Orion, and <code>$STRUTS_HOME</code> is the directory in
which you unpacked the Struts binary distribution.</p>
<ul>
- <li>Modify the file <code>$ORION_HOME/config/application.xml</code> to define
- the two new applications, by adding the following declarations, immediately
+ <li>Modify the file <code>$ORION_HOME/config/application.xml</code> to define
+ the two new applications, by adding the following declarations, immediately
following the <code>web-module</code> directive for the default web
application:</li>
</ul>
@@ -28,8 +28,8 @@
</pre>
<ul>
- <li>Modify the file <code>$ORION_HOME/config/default-web-site.xml</code> (or
- the configuration file for any other Orion web site) to include the following
+ <li>Modify the file <code>$ORION_HOME/config/default-web-site.xml</code> (or
+ the configuration file for any other Orion web site) to include the following
declarations, after the declaration for the <default-web-app> if any:</li>
</ul>
@@ -40,7 +40,7 @@
</pre>
<ul>
- <li>After you start Orion, you should now be able to access these applications
+ <li>After you start Orion, you should now be able to access these applications
(assuming you haven't changed the port number from the default of 80) at:</li>
</ul>
@@ -49,30 +49,30 @@
</pre>
<ul>
- <li>Versions of Orion up to at least 1.0.3 have a bug related to
ServletContext.getResource()
- calls that prevent the Struts example application from working out of the
- box. This manifests itself as a JSP error when you try to access the example
+ <li>Versions of Orion up to at least 1.0.3 have a bug related to
ServletContext.getResource()
+ calls that prevent the Struts example application from working out of the
+ box. This manifests itself as a JSP error when you try to access the example
application, with the following message:<br/>
<code>javax.servlet.jsp.JspException: Missing resources
attributeorg.apache.struts.action.MESSAGE</code><br/>
- followed by an error traceback. There will also be an initialization error
- message in the <code>ORION_HOME/log/global-application.log</code> log file.
+ followed by an error traceback. There will also be an initialization error
+ message in the <code>ORION_HOME/log/global-application.log</code> log file.
To work around this problem, you can take the following steps:</li>
<ul>
- <li>Go to the <code>$STRUTS_HOME/webapps</code> directory, where you will
- note that Orion has automatically expanded each web application into an
+ <li>Go to the <code>$STRUTS_HOME/webapps</code> directory, where you will
+ note that Orion has automatically expanded each web application into an
unpacked directory structure.</li>
- <li>Go to the <code>$STRUTS_HOME/webapps/struts-example/WEB-INF</code>
directory,
- and copy the file <code>struts-config.xml</code> one directory up (that
+ <li>Go to the <code>$STRUTS_HOME/webapps/struts-example/WEB-INF</code>
directory,
+ and copy the file <code>struts-config.xml</code> one directory up (that
is, into <code>$STRUTS_HOME/webapps/struts-example</code>.</li>
- <li>Modify the <code>$STRUTS_HOME/webapps/struts-example/WEB-INF/web.xm</code>
- file, changing the value of the "config" initialization parameter (for the
+ <li>Modify the <code>$STRUTS_HOME/webapps/struts-example/WEB-INF/web.xm</code>
+ file, changing the value of the "config" initialization parameter (for the
action servlet) from <code>/WEB-INF/struts-config.xml</code> to
<code>/action.xml</code>.</li>
<li>Restart Orion, and you should be able to access the example
application.</li>
- <li>Note that this workaround has a negative security-related side effect:
- your <code>struts-conifig.xml</code> file can now be retrieved by remote
+ <li>Note that this workaround has a negative security-related side effect:
+ your <code>struts-conifig.xml</code> file can now be retrieved by remote
clients at the following URL:<br/>
<code>http://localhost/struts-example/struts-config.xml</code><br/>
- Therefore, you should be sure you do not store sensitive information (such
+ Therefore, you should be sure you do not store sensitive information (such
as database passwords) in this file. </li>
</ul>
</ul>
@@ -80,5 +80,6 @@
<hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
</section>
+</chapter>
</body>
</document>
1.2 +36 -35 jakarta-struts/doc/userGuide/installation-jr30.xml
Index: installation-jr30.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-jr30.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-jr30.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-jr30.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -8,8 +8,8 @@
</properties>
<body>
-
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="jrun">JRUN 3.0 SP2A, VERSION 3.02A.11614</a></h3>
@@ -20,26 +20,26 @@
<p>At the moment, JRun is not fully compliant with the JSP 1.1/1.2
specification. </p>
-<p>Specifically, the automatic type conversions for custom tag parameters
-specified in "Issue 7" of the JSP 1.1 Errata and in the JSP 1.2 Proposed
+<p>Specifically, the automatic type conversions for custom tag parameters
+specified in "Issue 7" of the JSP 1.1 Errata and in the JSP 1.2 Proposed
Final Draft have not yet been implemented.</p>
<p>As it stands, JSP pages that make use of Struts taglibs whose parameters
-require conversion (such as booleans) will not compile under JRun. This
-includes the Struts Example Application. Attempting to run the example
-application will result in an exception similar to the following being
+require conversion (such as booleans) will not compile under JRun. This
+includes the Struts Example Application. Attempting to run the example
+application will result in an exception similar to the following being
thrown:</p>
<pre>
/struts-example/index.jsp:
-javax.servlet.ServletException: Compilation error occured:
+javax.servlet.ServletException: Compilation error occured:
-allaire.jrun.scripting.DefaultCFE:
+allaire.jrun.scripting.DefaultCFE:
Errors reported by compiler:
-c:/JRun/servers/default/Struts
- Example/WEB-INF/jsp/jrun__index2ejspa.java:41:1:41:27:
+c:/JRun/servers/default/Struts
+ Example/WEB-INF/jsp/jrun__index2ejspa.java:41:1:41:27:
Error: No match was found for method "setLocale(java.lang.String)".
</pre>
@@ -48,7 +48,7 @@
<font size="-1"><a
href="http://www.mail-archive.com/struts-user@jakarta.apache.org/msg01860.html";>http://www.mail-archive.com/struts-user@jakarta.apache.org/msg01860.html</a></font>)</p>
<p>The following instructions describe how to install the Struts Example
-Application under JRun. A subsequent section describes how the Struts Example
+Application under JRun. A subsequent section describes how the Struts Example
Application can be patched to work with Struts</p>
<p>The following instructions assume the following:</p>
@@ -56,13 +56,13 @@
<ul>
<li>JRun has been installed and integrated with the web server of choice.</li>
-<li>$APP_SERVER_NAME is the name of the application server used to host the
- application. (When JRun is first installed, it creates an application
+<li>$APP_SERVER_NAME is the name of the application server used to host the
+ application. (When JRun is first installed, it creates an application
server called JRun Default Server).</li>
-<li>$APP_SERVER_DIR is the directory used to hold applications hosted by
- $APP_SERVER_NAME. For the JRun Default Server, the directory is
- $JRUN_HOME/servers/default where $JRUN_HOME is the directory where
+<li>$APP_SERVER_DIR is the directory used to hold applications hosted by
+ $APP_SERVER_NAME. For the JRun Default Server, the directory is
+ $JRUN_HOME/servers/default where $JRUN_HOME is the directory where
JRun is installed.</li>
</ul>
@@ -75,36 +75,36 @@
current server status will be shown on the right pane.</li>
<li>On the right pane, click on the WAR Deployment link. A page
- containing a list of the currently deployed web applications will be
+ containing a list of the currently deployed web applications will be
shown.</li>
-<li>On the right pane, click on Deploy an Application. Complete the Web
+<li>On the right pane, click on Deploy an Application. Complete the Web
Application Information form as follows:</li>
-
+
<ul>
<li>Servlet War File or Directory: Enter the full path where
- struts-example.war is found or click on Browse to select
+ struts-example.war is found or click on Browse to select
the path.</li>
<li>JRun Server Name: $APP_SERVER_NAME</li>
<li>Application Name: Struts Example</li>
<li>Application Hosts: All Hosts</li>
<li>Application URL: /struts-example</li>
- <li>Application Deploy Directory: will default to
- $APP_SERVER_NAME/Struts Example (or the name as specified for
+ <li>Application Deploy Directory: will default to
+ $APP_SERVER_NAME/Struts Example (or the name as specified for
Application Name).</li>
</ul>
<li>Once the form is complete, click on the Deploy button.</li>
<li>If deployment is successful, restart the application server by
- clicking on <code>$APP_SERVER_NAME</code> on the left pane. A page showing the
- current server status will be shown on the right pane. Click the
+ clicking on <code>$APP_SERVER_NAME</code> on the left pane. A page showing the
+ current server status will be shown on the right pane. Click the
Restart Server button to restart the application server.</li>
<li>Test the sample application by using the following URL in the
browser:<br/>
<code>http://hostname/struts-example/index.jsp</code><br/>
- The struts-documentation.war can be installed using the same
+ The struts-documentation.war can be installed using the same
procedure.</li>
</ul>
@@ -134,19 +134,19 @@
<li>Click on Create to submit the form.</li>
<li>Once the web application is created, install and configure the struts
- components (struts.jar, struts*.tld, etc) for the web application under
+ components (struts.jar, struts*.tld, etc) for the web application under
<code>$APP_SERVER_NAME/myApplication/WEB-INF</code></li>
-
+
<li>Install the remaining components of the application: .class files,
JSP pages,.properties files etc as required.</li>
<li>To configure the extension mapping of the request URI (ie *.do) to
- the action servlet, expand <code>$APP_SERVER_NAME</code> on the left pane, expand
- the Web Applications branch and click on myApplication. The right pane
- will display the configuration options for myApplication. Click on
- Servlet URL Mappings. A list of existing mappings will be shown. Click
+ the action servlet, expand <code>$APP_SERVER_NAME</code> on the left pane, expand
+ the Web Applications branch and click on myApplication. The right pane
+ will display the configuration options for myApplication. Click on
+ Servlet URL Mappings. A list of existing mappings will be shown. Click
the Edit button and create the following entry:</li>
-
+
<ul>
<li>Virtual Path/Extension: *.do</li>
<li>Servlet Invoked: action</li>
@@ -169,18 +169,19 @@
<h4>Patching the struts example application</h4>
<p>As mentioned at the beginning of these notes, the Struts Example Application
-will not run under JRun without modification. The following changes will need
+will not run under JRun without modification. The following changes will need
to be made:</p>
<ul>
<li>index.jsp, logon.jsp: Change <html:html locale="true"> to <br/><html:html
locale=<%= true %>></li>
<li>logon.jsp: Change <html:html redisplay="true"> to <br/><html:html
redisplay=<%= true %>></li>
<li>registration.jsp, subscription.jsp: Change all instances of filter="true" to
<br/>filter=<%= true %></li>
-</ul>
+</ul>
<hr/>
<ul><li>Author: Eric Wu, Mark Budai</li></ul>
<hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
</section>
+</chapter>
</body>
</document>
1.2 +5 -7 jakarta-struts/doc/userGuide/installation-jetty.xml
Index: installation-jetty.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-jetty.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-jetty.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-jetty.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -3,12 +3,13 @@
<document url="./installation-ip.xml">
<properties>
- <author>Paul Runyan</author>
+ <author>Paul Runyan</author>
<title>The Struts Framework Project - Installation - Jetty</title>
</properties>
<body>
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="jetty">Jetty Java HTTP Servlet Server</a></h3>
@@ -115,12 +116,9 @@
</pre>
<hr/>
-<ul>
- <li>Author: Paul Runyan</li>
-</ul>
-<hr/>
<p>Back to <a href="installation.html#Containers">Installation</a></p>
-</section>
+</section>
+</chapter>
</body>
</document>
1.2 +7 -9 jakarta-struts/doc/userGuide/installation-ipas.xml
Index: installation-ipas.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-ipas.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-ipas.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-ipas.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -5,6 +5,7 @@
<title>The Struts Framework Project - Installation - iPortal Application
Server</title>
</properties>
<body>
+ <chapter name="5.2 Installation" href="installation">
<section name="Installing Struts with your servlet container"
href="Containers">
<h3>
<a name="ipas13">iPortal Application Server 1.3</a>
@@ -13,13 +14,13 @@
<h4>Important Note:</h4>
<p>At the moment, iPAS 1.3 is not fully compliant with the JSP 1.1/1.2
specification. </p>
- <p>Specifically, the automatic type conversions for custom tag
parameters
-specified in "Issue 7" of the JSP 1.1 Errata and in the JSP 1.2 Proposed
+ <p>Specifically, the automatic type conversions for custom tag
parameters
+specified in "Issue 7" of the JSP 1.1 Errata and in the JSP 1.2 Proposed
Final Draft have not yet been implemented.</p>
<p>As it stands, JSP pages that make use of Struts taglibs whose
parameters
-require conversion (such as booleans) will not compile under JRun. This
-includes the Struts Example Application. Attempting to run the example
-application will result in an exception similar to the following being
+require conversion (such as booleans) will not compile under JRun. This
+includes the Struts Example Application. Attempting to run the example
+application will result in an exception similar to the following being
thrown:</p>
<pre>
/struts-example/index.jsp:
@@ -147,12 +148,9 @@
<li>registration.jsp, subscription.jsp: Change all instances of
filter="true" to <br/>filter=<%= true %></li>
</ul>
<hr/>
- <ul>
- <li>Author: John Ueltzhoeffer</li>
- </ul>
- <hr/>
<p>Back to <a href="installation.html#Containers">Installation</a>
</p>
</section>
+ </chapter>
</body>
</document>
1.2 +14 -16 jakarta-struts/doc/userGuide/installation-ip.xml
Index: installation-ip.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation-ip.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- installation-ip.xml 20 Feb 2002 00:41:14 -0000 1.1
+++ installation-ip.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -1,41 +1,39 @@
<?xml version="1.0"?>
<document url="./installation-ip.xml">
<properties>
-<author>Stanley Santiago</author>
+<author>Stanley Santiago</author>
<title>The Struts Framework Project - Installation - iPlanet</title>
</properties>
<body>
-<section name="Installing Struts with your servlet container" href="Containers">
+<chapter name="5.2 Installation" href="installation">
+<section name="Installing Struts with your servlet container" href="Containers">
<h3><a name="ipws42">iPlanet Application Server 6.0</a></h3>
<p>Service Pack 2 is recommended.</p>
-<p>NOTE: At present, the Struts example application still uses a non-Serializable
-servlet context attribute, and will not run in an environment that requires them,
+<p>NOTE: At present, the Struts example application still uses a non-Serializable
+servlet context attribute, and will not run in an environment that requires them,
like iPlanet Application Server.</p>
<h3><a name="ipws42">iPlanet Web Server 4.2</a></h3>
-<p>Here are the issues I ran into while moving my struts based application from
- Tomcat (supports WebApps and WAR) to iWS 4.1 (does <b>NOT</b> support Webapps
+<p>Here are the issues I ran into while moving my struts based application from
+ Tomcat (supports WebApps and WAR) to iWS 4.1 (does <b>NOT</b> support Webapps
and WAR). </p>
<p>Webapps and WAR will be supported in iWS 5.0, as mentioned in iWS5.0 roadmap.</p>
<h4>Classpath issues.</h4>
-<p>This s pretty straightforward. Since there is no notion of
<code>WEB-INF/lib</code> and
- <code>WEB-INF/classes</code> the classpath has to be explicitly set in
+<p>This s pretty straightforward. Since there is no notion of
<code>WEB-INF/lib</code> and
+ <code>WEB-INF/classes</code> the classpath has to be explicitly set in
<code>$SERVER_ROOT/config/jvm12.conf</code>.</p>
<h4>Context relative paths</h4>
-<p>All URLs should be visible from the document root. In my case I just created
+<p>All URLs should be visible from the document root. In my case I just created
a symbolic link from <code>$DOCROOT/myapp</code> to
<code>webapps/myapp</code>.</p>
<h4>Extension mapping</h4>
-<p>The config file <code>$SERVER_ROOT/config/rules.properties</code> has a similar
mechanism
+<p>The config file <code>$SERVER_ROOT/config/rules.properties</code> has a similar
mechanism
as in web.xml.</p>
-<p>I have this in my <code>rules.properties</code> which forwards all urls ending
with "do"
+<p>I have this in my <code>rules.properties</code> which forwards all urls ending
with "do"
to the servlet whose logical name is action.</p>
<pre>####
@.*[.]do$=action
####</pre>
<hr/>
-<ul>
- <li>Author: Stanley Santiago</li>
-</ul>
-<hr/>
-<p>Back to <a href="installation.html#Containers">Installation</a></p></section>
+<p>Back to <a href="installation.html#Containers">Installation</a></p></section>
+</chapter>
</body>
</document>
1.14 +26 -8 jakarta-struts/doc/userGuide/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/index.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- index.xml 28 Jul 2002 02:25:58 -0000 1.13
+++ index.xml 31 Aug 2002 13:15:02 -0000 1.14
@@ -3,15 +3,35 @@
<properties>
<author>Craig R. McClanahan</author>
+ <author>David Geary</author>
<author>Mike Schachter</author>
- <author>Larry McCay</author>
<author>Ted Husted</author>
+ <author>Martin Cooper</author>
+ <author>Arron Bates</author>
+ <author>Cedric Dumoulin</author>
+ <author>David Winterfeldt</author>
+ <author>Chris Assenza</author>
+ <author>dIon Gillard</author>
+ <author>Dominique Plante</author>
+ <author>Ed Burns</author>
+ <author>Eric Wu</author>
+ <author>James DeVries</author>
+ <author>John Rousseau</author>
+ <author>John Ueltzhoeffer</author>
+ <author>Larry McCay</author>
+ <author>Mark Budai</author>
+ <author>Matthias Kerkhoff</author>
+ <author>Paul Runyan</author>
+ <author>Robert Hayden</author>
+ <author>Robert Leland</author>
+ <author>Stanley Santiago</author>
+ <author>Wong Kok Kai</author>
<title>The Struts User's Guide - Table of Contents</title>
</properties>
<body>
- <chapter name="0. Contents" href="contents">
+ <!-- Omit chapter heading for the list of chapters (also omits authors) -->
<section name="Table of Contents" href="toc">
@@ -29,8 +49,8 @@
<li><a href="preface.html#xml">0.9 Extensible Markup Language</a></li>
<li><a href="preface.html#jaas">0.10 JAAS</a></li>
</ul></li>
-
-
+
+
<li><a href="introduction.html">1. Introduction</a>
<ul>
<li><a href="introduction.html#history">1.1 Forward into the
Past!</a></li>
@@ -99,7 +119,7 @@
<li><a href="building_controller.html#logging">4.9 Using The
Commons Logging Interface</a></li>
<li>5. Getting Started</li>
<ul>
- <li><a href="release-notes.html">Release Notes</a></li>
+ <li><a href="release-notes.html">5.1 Release Notes</a></li>
<ul>
<li><a href="release-notes-1.1-b1.html">Release Notes
1.1-b1</a></li>
<li><a href="release-notes-1.0.2.html">Release Notes 1.0.2</a></li>
@@ -109,7 +129,7 @@
<li><a href="release-notes-1.0-b2.html">Release Notes
1.0-b2</a></li>
<li><a href="release-notes-1.0-b1.html">Release Notes
1.0-b1</a></li>
</ul>
- <li><a href="installation.html">Installation</a></li>
+ <li><a href="installation.html">5.2 Installation</a></li>
<ul>
<li><a href="installation-ip.html">iPlanet</a></li>
<li><a href="installation-ipas.html">Portal Application
Server</a></li>
@@ -127,8 +147,6 @@
</ul>
</section>
-
- </chapter>
</body>
1.4 +4 -4 jakarta-struts/doc/userGuide/dev_validator.xml
Index: dev_validator.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_validator.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- dev_validator.xml 7 Jul 2002 22:03:00 -0000 1.3
+++ dev_validator.xml 31 Aug 2002 13:15:02 -0000 1.4
@@ -1,8 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="./resources.xml">
<properties>
-<author>Ted Husted</author>
-<author>David Winterfeldt</author>
+ <author>David Winterfeldt</author>
<title>The Struts User's Guide - Validator Guide</title>
</properties>
<body>
@@ -24,13 +23,14 @@
</section>
+<!--
+ <author>Ted Husted</author>
<section href="resources" name="Validator Resources">
-
<p><b><u>Validating Input</u></b> by David Winterfeldt and Ted Husted.
Sample chapter from <u>Java Web Development with Struts</u>; available as a
<u>free download</u> (PDF).
</p>
-
</section>
+-->
</chapter></body></document>
1.2 +2 -2 jakarta-struts/doc/userGuide/dev_util.xml
Index: dev_util.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_util.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- dev_util.xml 29 Jun 2002 14:12:01 -0000 1.1
+++ dev_util.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="./resources.xml">
<properties>
-<author>Ted Husted</author>
-<title>The Struts User's Guide - Utilities Guide</title>
+ <author>Craig R. McClanahan</author>
+ <title>The Struts User's Guide - Utilities Guide</title>
</properties>
<body>
<chapter name="Utilities Guide">
1.8 +5 -2 jakarta-struts/doc/userGuide/dev_tiles.xml
Index: dev_tiles.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_tiles.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- dev_tiles.xml 26 Jul 2002 13:18:10 -0000 1.7
+++ dev_tiles.xml 31 Aug 2002 13:15:02 -0000 1.8
@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="./resources.xml">
<properties>
- <author>Ted Husted</author>
<author>Cedric Dumoulin</author>
<title>The Struts User's Guide - Tiles Guide</title>
</properties>
@@ -240,13 +239,17 @@
<a
href="http://www.javaworld.com/javaworld/jw-01-2002/jw-0104-tilestrut.html";>
<b>UI design with Tiles and Struts</b>
</a> by Prakash Malani.</p>
- <p>
+
+<!--
+<author>Ted Husted</author>
+<p>
<b>
<u>Developing applications with
Tiles</u>
</b> by Cedric Dumoulin and Ted Husted.
Sample chapter from <u>Java Web Development with Struts</u>; available as a
<u>free download</u> (PDF).
</p>
+-->
</section>
</chapter>
</body>
1.2 +3 -2 jakarta-struts/doc/userGuide/dev_template.xml
Index: dev_template.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_template.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- dev_template.xml 29 Jun 2002 03:21:02 -0000 1.1
+++ dev_template.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -1,8 +1,9 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="./resources.xml">
<properties>
-<author>Ted Husted</author>
-<title>The Struts User's Guide - Template Taglib Guide</title>
+ <author>David Geary</author>
+ <author>Ted Husted</author>
+ <title>The Struts User's Guide - Template Taglib Guide</title>
</properties>
<body>
<chapter name="Template Taglib Guide">
1.2 +1 -1 jakarta-struts/doc/userGuide/dev_nested.xml
Index: dev_nested.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_nested.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- dev_nested.xml 29 Jun 2002 03:21:02 -0000 1.1
+++ dev_nested.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="./resources.xml">
<properties>
-<author>Ted Husted</author>
+<author>Arron Bates</author>
<title>The Struts User's Guide - Nested Taglib Guide</title>
</properties>
<body>
1.2 +3 -2 jakarta-struts/doc/userGuide/dev_logic.xml
Index: dev_logic.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_logic.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- dev_logic.xml 29 Jun 2002 03:21:02 -0000 1.1
+++ dev_logic.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -1,8 +1,9 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="./resources.xml">
<properties>
-<author>Ted Husted</author>
-<title>The Struts User's Guide - Logic Taglib Guide</title>
+ <author>Craig R. McClanahan</author>
+ <author>Mike Schachter</author>
+ <title>The Struts User's Guide - Logic Taglib Guide</title>
</properties>
<body>
<chapter name="Logic Taglib Guide">
1.2 +9 -6 jakarta-struts/doc/userGuide/dev_html.xml
Index: dev_html.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_html.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- dev_html.xml 29 Jun 2002 03:21:02 -0000 1.1
+++ dev_html.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -1,17 +1,20 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="./resources.xml">
<properties>
-<author>Ted Husted</author>
-<title>The Struts User's Guide - HTML Taglib Guide</title>
+ <author>Craig R. McClanahan</author>
+ <author>Ted Husted</author>
+ <author>Martin Cooper</author>
+ <author>Mike Schachter</author>
+ <title>The Struts User's Guide - HTML Taglib Guide</title>
</properties>
-<body>
-<chapter name="HTML Taglib Guide">
+<body>
+<chapter name="HTML Taglib Guide">
<section href="html" name="The HTML Taglib">
<p>
-The tags in the Struts HTML library form a bridge between a JSP view and the other
components of a Web application.
-Since a dynamic Web application often depends on gathering data from a user, input
forms play an important role in
+The tags in the Struts HTML library form a bridge between a JSP view and the other
components of a Web application.
+Since a dynamic Web application often depends on gathering data from a user, input
forms play an important role in
the Struts framework. Consequently, the majority of the HTML tags involve HTML
forms.
</p>
1.2 +2 -3 jakarta-struts/doc/userGuide/dev_bean.xml
Index: dev_bean.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_bean.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- dev_bean.xml 29 Jun 2002 03:21:02 -0000 1.1
+++ dev_bean.xml 31 Aug 2002 13:15:02 -0000 1.2
@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<document url="./resources.xml">
<properties>
-<author>Ted Husted</author>
-<author>Cedric Dumoulin</author>
-<title>The Struts User's Guide - Bean Taglib Guide</title>
+ <author>Craig R. McClanahan</author>
+ <title>The Struts User's Guide - Bean Taglib Guide</title>
</properties>
<body>
<chapter name="Bean Taglib Guide">
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
