You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by hu...@apache.org on 2002/12/29 18:00:56 UTC

cvs commit: jakarta-struts/doc/userGuide struts-html.xml release-notes.xml

husted      2002/12/29 09:00:56

  Modified:    doc/userGuide struts-html.xml release-notes.xml
  Log:
  Apply patch for PR #13645 contributed by James Turner.
  
  Revision  Changes    Path
  1.45      +123 -75   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.44
  retrieving revision 1.45
  diff -u -r1.44 -r1.45
  --- struts-html.xml	24 Dec 2002 02:01:33 -0000	1.44
  +++ struts-html.xml	29 Dec 2002 17:00:56 -0000	1.45
  @@ -5,6 +5,7 @@
     <author>Craig R. McClanahan</author>
     <author>Martin Cooper</author>
     <author>Mike Schachter</author>
  +  <author>James Turner</author>
     <title>The Struts Framework Project - HTML Tags</title>
   </properties>
   
  @@ -1425,7 +1426,7 @@
               </info>
           </attribute>
   
  -		<attribute>
  +        <attribute>
               <name>focusIndex</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
  @@ -1663,9 +1664,26 @@
               end of the URL that is created by any of the above mechanisms,
               by using the <code>anchor</code> attribute.</p>
   
  -        </info>
  +         </info>
  + 
  +         <attribute>
  +           <name>action</name>
  +           <required>false</required>
  +           <rtexprvalue>true</rtexprvalue>
  +           <info>
  +               <p>Logical name of a global <code>Action</code> that
  +               contains the actual content-relative URI of the destination
  +               of this transfer.  This hyperlink may be dynamically
  +               modified by the inclusion of query parameters, as described
  +               in the tag description.  You <strong>must</strong> specify
  +               exactly one of the <code>action</code> attribute, the
  +               <code>forward</code> attribute, the
  +               <code>href</code> attribute,
  +               or the <code>page</code> attribute.</p>
  +           </info>
  +       </attribute>
   
  -        <attribute>
  +       <attribute>
               <name>anchor</name>
               <required>false</required>
               <rtexprvalue>true</rtexprvalue>
  @@ -1686,10 +1704,11 @@
                   of this transfer.  This hyperlink may be dynamically
                   modified by the inclusion of query parameters, as described
                   in the tag description.  You <strong>must</strong> specify
  -                exactly one of the <code>forward</code> attribute, the
  +                exactly one of the <code>action</code> attribute, the
  +                <code>forward</code> attribute, the
                   <code>href</code> attribute,
                   or the <code>page</code> attribute.</p>
  -            </info>
  +             </info>
           </attribute>
   
           <attribute>
  @@ -1718,13 +1737,14 @@
               <rtexprvalue>true</rtexprvalue>
               <info>
                   <p>The URL to which this hyperlink will transfer control
  -                if activated.  This hyperlink may be dynamically modified
  -                by the inclusion of query parameters, as described in the
  -                tag description.  You <strong>must</strong> specify
  -                exactly one of the <code>forward</code> attribute, the
  -                <code>href</code> attribute,
  -                or the <code>page</code> attribute.</p>
  -            </info>
  +                 if activated.  This hyperlink may be dynamically modified
  +                 by the inclusion of query parameters, as described in the
  +                 tag description.  You <strong>must</strong> specify
  +                 exactly one of the <code>action</code> attribute, the
  +                 <code>forward</code> attribute, the
  +                 <code>href</code> attribute,
  +                 or the <code>page</code> attribute.</p>
  +             </info>
           </attribute>
   
           <attribute>
  @@ -1789,13 +1809,14 @@
               <info>
                   <p>The application-relative path (beginning with a "/"
                   character) to which this hyperlink will transfer control
  -                if activated.  This hyperlink may be dynamically modified
  -                by the inclusion of query parameters, as described in the
  -                tag description.  You <strong>must</strong> specify exactly
  -                one of the <code>forward</code> attribute, the
  -                <code>href</code> attribute,
  -                or the <code>page</code> attribute.</p>
  -                </info>
  +                 if activated.  This hyperlink may be dynamically modified
  +                 by the inclusion of query parameters, as described in the
  +                 tag description.  You <strong>must</strong> specify exactly
  +                 one of the <code>action</code> attribute, the
  +                 <code>forward</code> attribute, the
  +                 <code>href</code> attribute,
  +                 or the <code>page</code> attribute.</p>
  +                 </info>
               </attribute>
   
           <attribute>
  @@ -3323,9 +3344,13 @@
                       name of a global <code>ActionForward</code> to be looked
                       up, and use the application-relative or context-relative
                       URI found there.</li>
  -                <li><em>href</em> - Use the value of this attribute unchanged.
  -                    </li>
  -                <li><em>page</em> - Use the value of this attribute as a
  +                <li><em>action</em> - Use the value of this attribute as the
  +                    name of a <code>Action</code> to be looked
  +                    up, and use the application-relative or context-relative
  +                    URI found there.</li>
  +                 <li><em>href</em> - Use the value of this attribute unchanged.
  +                     </li>
  +                 <li><em>page</em> - Use the value of this attribute as a
                       application-relative URI, and generate a server-relative
                       URI by including the context path and application
                       prefix.</li>
  @@ -3402,12 +3427,29 @@
                     <p>The keyboard character used to move focus immediately
                     to this element.</p>
                     </info>
  +                 </attribute>
  + 
  +                 <attribute>
  +                  <name>action</name>
  +                  <required>false</required>
  +                  <rtexprvalue>true</rtexprvalue>
  +                  <info>
  +                  <p>Logical name of a <code>Action</code> that
  +                  contains the actual content-relative URI of the destination
  +                  of this transfer.  This hyperlink may be dynamically
  +                  modified by the inclusion of query parameters, as described
  +                  in the tag description.  You <strong>must</strong> specify
  +                  exactly one of the <code>action</code> attribute, the
  +                  <code>forward</code> attribute, the
  +                  <code>href</code> attribute, the <code>linkName</code>
  +                  attribute, or the <code>page</code> attribute.</p>
  +                  </info>
                   </attribute>
   
                   <attribute>
  -                  <name>anchor</name>
  -                  <required>false</required>
  -                  <rtexprvalue>true</rtexprvalue>
  +                   <name>anchor</name>
  +                   <required>false</required>
  +                   <rtexprvalue>true</rtexprvalue>
                     <info>
                     <p>Optional anchor tag ("#xxx") to be added to the generated
                     hyperlink.  Specify this value <strong>without</strong> any
  @@ -3422,13 +3464,14 @@
                     <info>
                     <p>Logical name of a global <code>ActionForward</code> that
                     contains the actual content-relative URI of the destination
  -                  of this transfer.  This hyperlink may be dynamically
  -                  modified by the inclusion of query parameters, as described
  -                  in the tag description.  You <strong>must</strong> specify
  -                  exactly one of the <code>forward</code> attribute, the
  -                  <code>href</code> attribute, the <code>linkName</code>
  -                  attribute, or the <code>page</code> attribute.</p>
  -                  </info>
  +                   of this transfer.  This hyperlink may be dynamically
  +                   modified by the inclusion of query parameters, as described
  +                   in the tag description.  You <strong>must</strong> specify
  +                   exactly one of the <code>action</code> attribute, the
  +                   <code>forward</code> attribute, the
  +                   <code>href</code> attribute, the <code>linkName</code>
  +                   attribute, or the <code>page</code> attribute.</p>
  +                   </info>
                   </attribute>
   
                   <attribute>
  @@ -3437,13 +3480,14 @@
                     <rtexprvalue>true</rtexprvalue>
                     <info>
                     <p>The URL to which this hyperlink will transfer control
  -                  if activated.  This hyperlink may be dynamically modified
  -                  by the inclusion of query parameters, as described in the
  -                  tag description.  You <strong>must</strong> specify
  -                  exactly one of the <code>forward</code> attribute, the
  -                  <code>href</code> attribute, the <code>linkName</code>
  -                  attribute, or the <code>page</code> attribute.</p>
  -                  </info>
  +                   if activated.  This hyperlink may be dynamically modified
  +                   by the inclusion of query parameters, as described in the
  +                   tag description.  You <strong>must</strong> specify
  +                   exactly one of the <code>action</code> attribute, the
  +                   <code>forward</code> attribute, the
  +                   <code>href</code> attribute, the <code>linkName</code>
  +                   attribute, or the <code>page</code> attribute.</p>
  +                   </info>
                   </attribute>
   
           <attribute>
  @@ -3621,13 +3665,14 @@
                     <info>
                     <p>The application-relative path (beginning with a "/"
                     character) to which this hyperlink will transfer control
  -                  if activated.  This hyperlink may be dynamically modified
  -                  by the inclusion of query parameters, as described in the
  -                  tag description.  You <strong>must</strong> specify exactly
  -                  one of the <code>forward</code> attribute, the
  -                  <code>href</code> attribute, the <code>linkName</code>
  -                  attribute, or the <code>page</code> attribute.</p>
  -                  </info>
  +                   if activated.  This hyperlink may be dynamically modified
  +                   by the inclusion of query parameters, as described in the
  +                   tag description.  You <strong>must</strong> specify exactly
  +                   one of the <code>action</code> attribute,
  +                   <code>forward</code> attribute, the
  +                   <code>href</code> attribute, the <code>linkName</code>
  +                   attribute, or the <code>page</code> attribute.</p>
  +                   </info>
                   </attribute>
   
                   <attribute>
  @@ -5533,30 +5578,32 @@
                     <rtexprvalue>true</rtexprvalue>
                     <info>
                     <p>Logical name of a global <code>ActionForward</code> that
  -                  contains the actual content-relative URI of the destination
  -                  of this transfer.  This hyperlink may be dynamically
  -                  modified by the inclusion of query parameters, as described
  -                  in the tag description.  You <strong>must</strong> specify
  -                  exactly one of the <code>forward</code> attribute, the
  -                  <code>href</code> attribute, or the <code>page</code>
  -                  attribute.</p>
  -                  </info>
  +                   contains the actual content-relative URI of the destination
  +                   of this transfer.  This hyperlink may be dynamically
  +                   modified by the inclusion of query parameters, as described
  +                   in the tag description.  You <strong>must</strong> specify
  +                   exactly one of the <code>action</code> attribute, the
  +                   <code>forward</code> attribute, the
  +                   <code>href</code> attribute, or the <code>page</code>
  +                   attribute.</p>
  +                   </info>
                   </attribute>
  -
  +                
                   <attribute>
                     <name>href</name>
                     <required>false</required>
                     <rtexprvalue>true</rtexprvalue>
                     <info>
                     <p>The URL to which this hyperlink will transfer control
  -                  if activated.  This hyperlink may be dynamically modified
  -                  by the inclusion of query parameters, as described in the
  -                  tag description.  You <strong>must</strong> specify
  -                  exactly one of the <code>forward</code> attribute, the
  -                  <code>href</code> attribute, or the <code>page</code>
  -                  attribute.</p>
  -                  </info>
  -                </attribute>
  +                   if activated.  This hyperlink may be dynamically modified
  +                   by the inclusion of query parameters, as described in the
  +                   tag description.  You <strong>must</strong> specify
  +                   exactly one of the <code>action</code> attribute, the
  +                   <code>forward</code> attribute, the
  +                   <code>href</code> attribute, or the <code>page</code>
  +                   attribute.</p>
  +                   </info>
  +                 </attribute>
   
                   <attribute>
                     <name>name</name>
  @@ -5578,14 +5625,15 @@
                     <info>
                     <p>The application-relative path (beginning with a "/"
                     character) to which this hyperlink will transfer control
  -                  if activated.  This hyperlink may be dynamically modified
  -                  by the inclusion of query parameters, as described in the
  -                  tag description.  You <strong>must</strong> specify exactly
  -                  one of the <code>forward</code> attribute, the
  -                  <code>href</code> attribute, or the <code>page</code>
  -                  attribute.</p>
  -                  </info>
  -                </attribute>
  +                   if activated.  This hyperlink may be dynamically modified
  +                   by the inclusion of query parameters, as described in the
  +                   tag description.  You <strong>must</strong> specify exactly
  +                   one of the <code>action</code> attribute, the 
  +                   <code>forward</code> attribute, the
  +                   <code>href</code> attribute, or the <code>page</code>
  +                   attribute.</p>
  +                   </info>                
  +                 </attribute>
   
                   <attribute>
                     <name>paramId</name>
  @@ -6911,10 +6959,10 @@
             <bodycontent>empty</bodycontent>
             <info>
             <p>
  -          	Using this tag in a page tells all other html taglib tags
  -          	to render themselves as XHTML.  This is useful
  -          	when composing pages with JSP includes or Tiles.  This tag has the same effect
  -          	as using &lt;html:html xhtml="true"&gt;.
  +            Using this tag in a page tells all other html taglib tags
  +            to render themselves as XHTML.  This is useful
  +            when composing pages with JSP includes or Tiles.  This tag has the same effect
  +            as using &lt;html:html xhtml="true"&gt;.
             </p>
             </info>
   
  
  
  
  1.17      +6 -3      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.16
  retrieving revision 1.17
  diff -u -r1.16 -r1.17
  --- release-notes.xml	29 Dec 2002 11:45:44 -0000	1.16
  +++ release-notes.xml	29 Dec 2002 17:00:56 -0000	1.17
  @@ -191,8 +191,10 @@
   
       <p>
       <ul>
  -    <li>Scaffold - Library of reusable classes for building web applications.</li>
  -    <li>Service Manager - Add custom services without subclassing controller.</li>
  +    <li>Scaffold - An extension of the Commons Scaffold toolkit of reusable 
  +    classes for building web applications.</li>
  +    <li>Struts-el - The optional Struts-el taglib makes it easy to use Struts 
  +    with JSTL (container with servlet 2.3 support required). </li>    
       </ul>
       </p>
   
  @@ -246,7 +248,8 @@
       <p>The following new features have been added to the
       <em>struts-html</em> custom tag library [<code>org.apache.struts.taglib.html</code>]:</p>
       <ul>
  -    <li><code>&lt;options&gt;:</code> If the property specified by the 'property' attribute returns null, tag now throws an error message that indicates what the real problem is, rather than causing an NPE.</li>
  +    <li><code>&lt;html:link&gt;:</code> Added 'action' attribute.</li>
  +    <li><code>&lt;html:options&gt;:</code> If the property specified by the 'property' attribute returns null, tag now throws an error message that indicates what the real problem is, rather than causing an NPE.</li>
       <li><code>&lt;html:option&gt; and &lt;html:options&gt;:</code> Added 'style' and 'styleClass' attributes.</li>
       <li><code>&lt;html:optionsCollection&gt;:</code> New tag providing a cleaner way of populating HTML options from a collection.</li>
       <li><code>&lt;bean:message&gt;:</code> Added 'name', 'property' and 'scope' attributes so that the message resource key can be obtained dynamically from a bean.</li>
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>