husted 2004/07/04 16:58:29
Modified: doc project.xml
doc/faqs kickstart.xml
doc/stylesheets struts.xsl
doc/userGuide building_controller.xml configuration.xml
installation.xml introduction.xml release-notes.xml
Log:
Routine updates
Revision Changes Path
1.50 +1 -1 jakarta-struts/doc/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/project.xml,v
retrieving revision 1.49
retrieving revision 1.50
diff -u -r1.49 -r1.50
--- project.xml 9 Jun 2004 18:35:26 -0000 1.49
+++ project.xml 4 Jul 2004 23:58:28 -0000 1.50
@@ -69,7 +69,7 @@
/>
<item
name="Resource Directory"
- href="http://struts.sf.net/community/index.html";
+ href="http://wiki.apache.org/struts/StrutsResources";
/>
</menu>
1.17 +28 -29 jakarta-struts/doc/faqs/kickstart.xml
Index: kickstart.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/faqs/kickstart.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- kickstart.xml 4 Jul 2004 18:01:21 -0000 1.16
+++ kickstart.xml 4 Jul 2004 23:58:28 -0000 1.17
@@ -59,12 +59,17 @@
</section>
<section href="compat" name="Is Struts compatible with other Java technologies?">
-<p>Yes. Struts is committed to supporting industry standards. Our lead developer is
a member of <a
href="http://java.sun.com/aboutJava/communityprocess/jsr/jsr_052_jsptaglib.html";>JSR052</a>,
Sun's Expert group for developing a standard library of custom JSP tags. A primary
design criteria is that Struts must be compatible with Sun's J2EE platform for
corporate enterprises. In fact, Struts really acts as an integrator of Java
technologies, so that they can be used in the "real world".</p>
+<p>Yes. Struts is committed to supporting industry standards.
+ Struts acts as an integrator of Java technologies so that they can be used in
the "real world".</p>
</section>
<section href="who" name="Who wrote Struts?">
-<p>Struts was created by Craig R. McClanahan, and donated to The Apache Software
Foundation in May 2000. Craig is the primary developer of both Struts and <a
href="http://jakarta.apache.org/tomcat/index.html";>Tomcat 4</a>, the basis for the
official reference implementation for a servlet 2.3 and JSP 1.2 container. With stable
releases of Struts and Tomcat 4 in circulation, Craig is now the Specification Lead
for <a href="http://jcp.org/jsr/detail/127.jsp";>JavaServer Faces (JSR-127)</a>, and is
the Web Layer Architect for the Java2 Enterprise Edition (J2EE) platform as a
whole.</p>
-<p>There are now many active committers to the Struts project, working
cooperatively from around the globe. Other Java developers are invited to <a
href="helping.html#contribute">contribute to the project</a>. Struts is an <a
href="http://jakarta.apache.org/";>Apache Jakarta</a> project, with the common mission
to "provide commercial-quality server solutions based on the Java Platform that
are developed in an open and cooperative fashion". All told, 17 individual
developers and committers contributed to the Struts 1.0 codebase.</p>
+ <p>There are several <a href="../volunteers.html">active committers</a> to the
Struts project, working cooperatively from around the globe. Dozens of individual
developers and committers contributed to the Struts 1.x codebase. All interested Java
developers are invited to <a href="helping.html#contribute">contribute to the
project</a>.
+ Struts is a <a href="http://apache.org/";>Apache Software Foundation</a>
project, with the mission to "provide secure, enterprise-grade server solutions
based on the Java Platform that are developed in an open and cooperative
fashion".</p>
+ <p>Struts was created by Craig R. McClanahan and donated to The Apache Software
Foundation in May 2000. Craig was the primary developer of both Struts 1.x and <a
href="http://jakarta.apache.org/tomcat/index.html";>Tomcat 4</a>. Tomcat 4 was the
basis for the official reference implementation for a servlet 2.3 and JSP 1.2
container.</p>
+ <p>Craig's current focus is as architect of the Sun Java Studio Creator
(formerly Project Rave).
+ Craig also serves as the Specification Lead for <a
href="http://jcp.org/jsr/detail/127.jsp";>JavaServer Faces (JSR-127)</a>,
+ and is the Web Layer Architect for the Java2 Enterprise Edition (J2EE) platform
as a whole.</p>
</section>
<section href="struts" name="Why is it called Struts?">
@@ -72,12 +77,11 @@
</section>
<section href="license" name="How is Struts licensed?">
-<p>Struts is copyrighted software available under a "free-to-use-license"
by The Apache Software Foundation. The license appears at the head of every source
code file. A reference copy of the license is available <a
href="http://www.apache.org/LICENSE-1.1";>here</a>.</p>
+<p>Struts is copyrighted software available under the <a
href="http://www.apache.org/licenses";>Apache License</a>, a "free-to-use,
business-friendly license".</p>
</section>
<section href="usage" name="Can Struts be used in a commercial product?">
-<p>Yes. The only requirements you must meet are those listed in the Apache Software
Foundation license, which is included at the top of each source file and in the file
LICENSE in the top-level directory of the distribution.</p>
-<p>In addition, <a href="helping.html#bugs">contributions of patches, improved
code, new features,</a> or even just requests for features are also welcome.</p>
+<p>Yes. The only requirements you must meet are those listed in the <a
href="http://www.apache.org/licenses";>Apache License</a>.</p>
</section>
<section href="credits" name="Do I have to credit Struts on my own website?">
@@ -89,7 +93,7 @@
</section>
<section href="where" name="Where can I get a copy of Struts?">
-<p>The best place to download Struts is at <a
href="http://jakarta.apache.org/struts/";>jakarta.apache.org/struts</a>. The nightly
builds are very stable, and recommended as the best place to start today.</p>
+<p>The best place to download Struts is at <a
href="http://struts.apache.org/";>struts.apache.org</a>. The nightly builds are very
stable, and recommended as the best place to start today.</p>
</section>
<section href="install" name="How do I install Struts?">
@@ -150,7 +154,7 @@
We don't charge anyone anything to use Struts.
Committers and other developers work on Struts because they need to use it with
their own applications.
If others can use it too, that's "icing on the cake".
-If you submit a patch for a feature that a Committer finds useful, then that
Committer may choose to volunteer his or her time to apply the patch.
+If you <a href="../helping.html">submit a patch</a> for a feature that a Committer
finds useful, then that Committer may choose to volunteer his or her time to apply the
patch.
If you just submit an idea without a patch, it is much less likely to be added
(since first someone else has to volunteer their time to write the patch).
</p>
<p>
@@ -167,11 +171,11 @@
along with the <strong>full source code</strong>. For your convenience, these are
bundled together as
a self-installing application. The <code>struts-documentation.war</code> is the same
bundle that is deployed as the
-<a href="http://jakarta.apache.org/struts/";>Struts Web site</a>.
+<a href="http://struts.apache.org/";>Struts Web site</a>.
</p>
<p>
The
-<a href="http://jakarta.apache.org/site/mail.html";>Strut's mailing list</a> is also
+<a href="http://struts.apache.org/using.html#lists";>Strut's mailing list</a> is also
very active, and welcomes posts from new users. Before posting a new question, be
sure to consult the
<a href="http://www.mail-archive.com/struts-user%40jakarta.apache.org/";>
@@ -259,10 +263,9 @@
desktop.
</p>
<p>
-The inventor of Struts, Craig McClanahan, was a member of the
-expert group for the JavaServer Standard Tag Library (JSR 052) and
-is now the specification co-lead for JavaServer Faces (JSR 127). Both
-technologies are complementary to Struts.</p>
+The inventor of Struts, Craig McClanahan, is the specification co-lead for
+JavaServer Faces (JSR 127), and architect of the reference implemenation
+as well as Java Studio Creator. Both JSTL and JSF are complementary to Struts.</p>
<p>
The mainstay of the Struts framework is the controller components, which
can be used with any Java presentation technology. As new technologies
@@ -284,12 +287,13 @@
</p>
<p>
The JSF specification and reference implementation is available through
Sun's
+ The JSF specification and reference implementation is available through
Sun's
<a href="http://java.sun.com/j2ee/javaserverfaces/index.jsp";>Java
ServerFaces page</a>.
An early-release JavaServer Faces taglib for Struts,
- <a href="http://cvs.apache.org/builds/jakarta-struts/nightly/struts-faces/";>
- <strong>Struts-Faces</strong></a>, is also in early release and available
- through the nightly build. The Struts Faces taglib is expected to work with
any
- compliant JSF implementation, including <a
href="http://www.myfaces.org/";>MyFaces</a>.
+ <strong>Struts-Faces</strong>, is also in early release and available
through the
+ <a
href="http://cvs.apache.org/builds/jakarta-struts/nightly/struts-faces/";>nightly
build</a>.
+ The Struts Faces taglib is expected to work with any compliant JSF
implementation, including
+ <a href="http://www.myfaces.org/";>MyFaces</a>.
</p>
<p>
For more about what JavaServer Faces means to the Struts community,
@@ -308,23 +312,18 @@
and <a href="http://www.netbeans.org/";>NetBeans</a>.
</p>
<p>
-At this writing, in the free zone, NetBeans had the edge with JSP editing, but
Eclipse has more advanced refactoring features.
-Eclipse is also a general-purpose IDE and can be used with non-Java projects.
-In the non-free zone, IDEA is highly regarded but costs money. (Of course, if *you*
cost money, good tools are often a good investment.)
-</p>
-<p>
See the <a href="../faqs/index.html">Howto Guides</a> for more about configuring
IDEs to work with Struts.
</p>
</section>
<section href="digest" name="Is there a digest for the User list?">
<p>
-Yes. <a href="mailto:[EMAIL PROTECTED]">send a blank message</a> to < <a
href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a>>.
+Yes. <a href="mailto:[EMAIL PROTECTED]">send a blank message</a> to < <a
href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a>>.
</p>
<p>
If you are subscribed to the digest, you can also post to the list.
Just be sure to send your post to the
-<a href="mailto:[EMAIL PROTECTED]">user list</a> rather than trying to reply to the
digest.
+<a href="mailto:[EMAIL PROTECTED]">user list</a> rather than trying to reply to the
digest.
</p>
</section>
@@ -340,19 +339,19 @@
<section href="mailbounce" name="Why didn't my posting show up on the user list?">
<p>
-You must be subscribed to the <a href="mailto:[EMAIL PROTECTED]">user list</a>
-or <a href="mailto:[EMAIL PROTECTED]">user digest</a> before posting
+You must be subscribed to the <a href="mailto:[EMAIL PROTECTED]">user list</a>
+or <a href="mailto:[EMAIL PROTECTED]">user digest</a> before posting
(or use the <a href="http://news.gmane.org";>GMane Newsgroups</a> instead).
</p>
</section>
<section href="unsubscribe" name="How do I unsubscribe from the mailing list?">
<p>
-<strong>From the email account used to subscribe to the list,</strong> <a
href="mailto:[EMAIL PROTECTED]">send a blank message</a> to < <a
href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a>>.
+<strong>From the email account used to subscribe to the list,</strong> <a
href="mailto:[EMAIL PROTECTED]">send a blank message</a> to < <a
href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a>>.
</p>
<p>
If you are receiving the digest, you must send a blank email to
-<<a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a>>
+<<a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a>>
instead.
</p>
</section>
1.23 +2 -2 jakarta-struts/doc/stylesheets/struts.xsl
Index: struts.xsl
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/stylesheets/struts.xsl,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- struts.xsl 6 Apr 2004 23:30:54 -0000 1.22
+++ struts.xsl 4 Jul 2004 23:58:28 -0000 1.23
@@ -139,7 +139,7 @@
</xsl:variable>
<img src="{$src}" alt="Powered by Struts" id="powered-logo"/>
Copyright (c) 2000-2004, The Apache Software Foundation <span
class="noprint">-
- <a
href="http://wiki.apache.org/struts?StrutsDocComments";>Comments?</a></span>
+ <a
href="http://wiki.apache.org/struts/StrutsDocComments";>Comments?</a></span>
</div>
<xsl:comment>end footer</xsl:comment>
1.80 +1 -0 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.79
retrieving revision 1.80
diff -u -r1.79 -r1.80
--- building_controller.xml 27 Apr 2004 22:34:01 -0000 1.79
+++ building_controller.xml 4 Jul 2004 23:58:28 -0000 1.80
@@ -734,6 +734,7 @@
available to conventional or DynaActionForms.
You might have difficulty referencing <a
href="../faqs/indexedprops.html">indexed or mapped properties</a>
using a map-backed ActionForm.
+ The <code>validwhen</code> validator (since Struts 1.2.1) also does not
support map-backed ActionForms.
</p>
</section>
1.32 +44 -38 jakarta-struts/doc/userGuide/configuration.xml
Index: configuration.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/configuration.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- configuration.xml 6 Apr 2004 23:30:54 -0000 1.31
+++ configuration.xml 4 Jul 2004 23:58:28 -0000 1.32
@@ -388,7 +388,7 @@
]]></code></pre>
<p>
- In Struts 1.2.0, the GenericDataSource has been removed, and it is
+ Since Struts 1.2.0, the GenericDataSource has been removed, and it is
recommended that you use the Commons BasicDataSource or other DataSource
implementation instead. In practice, if you need to use the DataSource
manager, you should use whatever DataSource implementation works best
@@ -442,7 +442,7 @@
</p>
<p>
- In Struts 1.1, you have two options: you can list
+ Since Struts 1.1, you have two options: you can list
<a href="#dd_config_servlet">multiple struts-config files</a> as a
comma-delimited list, or you can subdivide a larger application into
modules.
@@ -462,7 +462,7 @@
href="module_config-inform_controller">
<p>
- In struts 1.0, you listed your configuration file as an initialization
+ Since Struts 1.0, you listed your configuration file as an initialization
parameter to the action servlet in web.xml.
This is still done in 1.1, but it's augmented a little.
In order to tell the Struts machinery about your different modules, you
@@ -516,13 +516,44 @@
<section name="5.3.3 Switching Modules" href="module_config-switching">
<p>
- There are two basic methods to switching from one module to another.
- You can either use a forward (global or local) and specify the
- contextRelative attribute with a value of true, or you can use
- the built-in <code>org.apache.struts.actions.SwitchAction</code>.
+ There are three approaches for switching from one module to another.
+ You can you can use the built-in
<code>org.apache.struts.actions.SwitchAction</code>,
+ you can use a forward (global or local) and specify the contextRelative
attribute with a value of true,
+ or you can specify the "module" parameter as part of any of the Struts
hyperlink tags (Include, Img, Link, Rewrite, or Forward).
</p>
<p>
+ You can use <code>org.apache.struts.actions.SwitchAction</code> like so:
+ </p>
+
+<pre><code><![CDATA[
+ ...
+ <action-mappings>
+ <action path="/toModule"
+ type="org.apache.struts.actions.SwitchAction"/>
+ ...
+ </action-mappings>
+ ...
+]]></code></pre>
+
+ <p>
+ Now, to change to ModuleB, we would use a URI like this:
+ </p>
+
+ <pre><code>
+ http://localhost:8080/toModule.do?prefix=/moduleB&page=/index.do
+ </code></pre>
+
+ <p>
+ If you are using the "default" module as well as "named" modules (like
"/moduleB"),
+ you can switch back to the "default" module with a URI like this:
+ </p>
+
+ <pre><code>
+ http://localhost:8080/toModule.do?prefix=&page=/index.do
+ </code></pre>
+
+ <p>
Here's an example of a global forward:
</p>
@@ -565,37 +596,12 @@
]]></code></pre>
<p>
- Finally, you could use
- <code>org.apache.struts.actions.SwitchAction</code>,
- like so:
- </p>
-
-<pre><code><![CDATA[
- ...
- <action-mappings>
- <action path="/toModule"
- type="org.apache.struts.actions.SwitchAction"/>
- ...
- </action-mappings>
- ...
-]]></code></pre>
-
- <p>
- Now, to change to ModuleB, we would use a URI like this:
- </p>
-
- <pre><code>
- http://localhost:8080/toModule.do?prefix=/moduleB&page=/index.do
- </code></pre>
-
- <p>
- If you are using the "default" module as well as "named" modules (like
"/moduleB"),
- you can switch back to the "default" module with a URI like this:
+ Using the module parameter with a hyperlink tag is even simplier:
</p>
- <pre><code>
- http://localhost:8080/toModule.do?prefix=&page=/index.do
- </code></pre>
+ <pre><code><![CDATA[
+ <html:link module="moduleB" path="/index.do"/>
+ ]]></code></pre>
<p>
That's all there is to it! Happy module-switching!
@@ -788,7 +794,7 @@
<p>
<strong>WARNING</strong> - If you are using
- the new module support in Struts 1.1, you should be aware
+ the new module support since Struts 1.1, you should be aware
that <strong>only</strong> extension mapping is supported.
</p>
@@ -1025,7 +1031,7 @@
href="config_logging">
<p>
- In Struts 1.0, the logging functionality was fairly limited. You could
+ Since Struts 1.0, the logging functionality was fairly limited. You could
set a debugging detail level with a servlet initialization parameter, and
all log messages were written to wherever <code>ServletContext.log()</code>
output is sent by your servlet container. WIth Struts 1.1, however, all
1.40 +1 -1 jakarta-struts/doc/userGuide/installation.xml
Index: installation.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/installation.xml,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -r1.39 -r1.40
--- installation.xml 28 Mar 2004 03:59:45 -0000 1.39
+++ installation.xml 4 Jul 2004 23:58:28 -0000 1.40
@@ -97,7 +97,7 @@
<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.2 or later) </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>
</ul>
ANTLR is a public domain library; all other libraries are distributed under
the
1.20 +3 -4 jakarta-struts/doc/userGuide/introduction.xml
Index: introduction.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/introduction.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- introduction.xml 12 Dec 2003 03:20:53 -0000 1.19
+++ introduction.xml 4 Jul 2004 23:58:28 -0000 1.20
@@ -410,15 +410,14 @@
<p>
<a href="index.html">Other chapters</a> in this document cover the
various Struts components in greater detail. The Struts release also
- includes several Developer Guides covering various aspects of the
+ includes several Developer Guides covering various aspects of the
frameworks, along with sample applications, the standard Javadoc API,
and, of course, the complete source code!
</p>
<p>
- Struts is distributed under the Apache Software Foundation license. The
code
- is copyrighted, but is free to use in any application. See the
- <a href="http://www.apache.org/LICENSE-1.1";>ASF license</a> for
specifics.
+ Struts is distributed under the <a
href="http://www.apache.org/licenses/";>Apache Software Foundation license</a>.
+ The code is copyrighted, but is free to use in any application.
</p>
</section>
1.55 +0 -2 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.54
retrieving revision 1.55
diff -u -r1.54 -r1.55
--- release-notes.xml 1 Jul 2004 01:32:54 -0000 1.54
+++ release-notes.xml 4 Jul 2004 23:58:28 -0000 1.55
@@ -326,8 +326,6 @@
<ul>
<li>2003-08-23 - TagUtils: Deprecated getActionErrors() in favor of
getActionMessages().</li>
<li>2003-08-16 - TagUtils: Replaced ActionError with ActionMessage.</li>
- </ul>
- <ul>
<li>2003-08-02 - LocalStrings.properties,TagUtils: Move message resources
from util package.</li>
</ul>
<ul>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
