struts-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From hus...@apache.org
Subject cvs commit: jakarta-struts/doc/userGuide building_controller.xml configuration.xml installation.xml introduction.xml release-notes.xml
Date Sun, 04 Jul 2004 23:58:29 GMT
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 &quot;real world&quot;.</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 &quot;real
world&quot;.</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 &quot;provide commercial-quality server solutions
based on the Java Platform that are developed in an open and cooperative fashion&quot;.
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 &quot;provide secure, enterprise-grade server solutions
based on the Java Platform that are developed in an open and cooperative fashion&quot;.</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 &quot;free-to-use-license&quot;
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 &quot;free-to-use, business-friendly license&quot;.</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:struts-user-digest-subscribe@jakarta.apache.org">send a blank
message</a> to &lt; <a href="mailto:struts-user-digest-subscribe@jakarta.apache.org">struts-user-digest-subscribe@jakarta.apache.org</a>&gt;.
  +Yes. <a href="mailto:user-digest-subscribe@struts.apache.org">send a blank message</a>
to &lt; <a href="mailto:user-digest-subscribe@struts.apache.org">user-digest-subscribe@struts.apache.org</a>&gt;.
   </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:struts-user@jakarta.apache.org">user list</a> rather than trying
to reply to the digest.
  +<a href="mailto:user@struts.apache.org">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:struts-user-subscribe@jakarta.apache.org">user
list</a>
  -or <a href="mailto:struts-user-digest-subscribe@jakarta.apache.org">user digest</a>
before posting
  +You must be subscribed to the <a href="mailto:user-subscribe@struts.apache.org">user
list</a>
  +or <a href="mailto:user-digest-subscribe@struts.apache.org">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:struts-user-unsubscribe@jakarta.apache.org">send a blank message</a>
to &lt; <a href="mailto:struts-user-unsubscribe@jakarta.apache.org">struts-user-unsubscribe@jakarta.apache.org</a>&gt;.
  +<strong>From the email account used to subscribe to the list,</strong> <a
href="mailto:user-unsubscribe@struts.apache.org">send a blank message</a> to &lt;
<a href="mailto:user-unsubscribe@struts.apache.org">user-unsubscribe@struts.apache.org</a>&gt;.
   </p>
   <p>
   If you are receiving the digest, you must send a blank email to
  -&lt;<a href="mailto:struts-user-digest-unsubscribe@jakarta.apache.org">struts-user-unsubscribe@jakarta.apache.org</a>&gt;
  +&lt;<a href="mailto:user-digest-unsubscribe@struts.apache.org">user-unsubscribe@struts.apache.org</a>&gt;
   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&amp;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=&amp;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&amp;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=&amp;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: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org


Mime
View raw message