Author: husted Date: Tue Jul 11 15:03:41 2006 New Revision: 421008 URL: http://svn.apache.org/viewvc?rev=421008&view=rev Log: STR-1276 : Document multibox issues with map-backed beans.
Modified: struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/bean/package.html struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/html/package.html struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/logic/package.html struts/struts1/trunk/taglib/src/main/resources/META-INF/tld/struts-html.tld Modified: struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/bean/package.html URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/bean/package.html?rev=421008&r1=421007&r2=421008&view=diff ============================================================================== --- struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/bean/package.html (original) +++ struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/bean/package.html Tue Jul 11 15:03:41 2006 @@ -64,7 +64,7 @@ </ul> -<p>See the <a href="../../../../../../userGuide/struts-bean.html">Bean Tags +<p>See the <a href="../../../../../../tagreference.html">Bean Tags Reference</a> for detailed information about the available tags in this tag library, and the valid attributes for each tag.<br> @@ -391,7 +391,7 @@ and the request that is currently being processed. Not all of the attributes for each tag are illustrated in the examples below - see the <a - href="../../../../../../userGuide/struts-bean.html"> + href="../../../../../../tagreference.html"> Bean Tags Reference</a> for more information. Any bean created by these tags exists only in page scope, for the remainder of the current page.</p> @@ -514,7 +514,7 @@ the Locale must recently stored in the user's session. These defaults can be overridden by setting values for the "bundle" and "locale" attributes, as described in the <a - href="../../../../../../userGuide/struts-bean.html#message"> + href="../../../../../../tagreference.html#message"> Bean Tags Reference</a> . </p> <pre> <bean:message key="label.Cancel"/><br> <bean:message Modified: struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/html/package.html URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/html/package.html?rev=421008&r1=421007&r2=421008&view=diff ============================================================================== --- struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/html/package.html (original) +++ struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/html/package.html Tue Jul 11 15:03:41 2006 @@ -51,43 +51,43 @@ <ul> <li> - <a href="../../../../../../userGuide/struts-html.html#button">button</a> + <a href="../../../../../../tagreference.html#button">button</a> </li> <li> - <a href="../../../../../../userGuide/struts-html.html#cancel">cancel</a> + <a href="../../../../../../tagreference.html#cancel">cancel</a> </li> - <li><a href="../../../../../../userGuide/struts-html.html#checkbox">checkboxes</a> + <li><a href="../../../../../../tagreference.html#checkbox">checkboxes</a> </li> - <li><a href="../../../../../../userGuide/struts-html.html#file">file</a> + <li><a href="../../../../../../tagreference.html#file">file</a> </li> <li> - <a href="../../../../../../userGuide/struts-html.html#hidden">hidden</a> + <a href="../../../../../../tagreference.html#hidden">hidden</a> </li> - <li><a href="../../../../../../userGuide/struts-html.html#image">image</a> + <li><a href="../../../../../../tagreference.html#image">image</a> </li> - <li><a href="../../../../../../userGuide/struts-html.html#multibox">multibox</a> + <li><a href="../../../../../../tagreference.html#multibox">multibox</a> </li> - <li><a href="../../../../../../userGuide/struts-html.html#password">password</a> + <li><a href="../../../../../../tagreference.html#password">password</a> input fields</li> - <li><a href="../../../../../../userGuide/struts-html.html#radio">radio</a> + <li><a href="../../../../../../tagreference.html#radio">radio</a> buttons</li> - <li><a href="../../../../../../userGuide/struts-html.html#reset">reset</a> + <li><a href="../../../../../../tagreference.html#reset">reset</a> buttons</li> <li> - <a href="../../../../../../userGuide/struts-html.html#select">select</a> + <a href="../../../../../../tagreference.html#select">select</a> lists with embedded</li> <li> - <a href="../../../../../../userGuide/struts-html.html#option">option</a> + <a href="../../../../../../tagreference.html#option">option</a> </li> <li> - <a href="../../../../../../userGuide/struts-html.html#options">options</a> + <a href="../../../../../../tagreference.html#options">options</a> </li> <li> - <a href="../../../../../../userGuide/struts-html.html#submit">submit</a> + <a href="../../../../../../tagreference.html#submit">submit</a> buttons</li> - <li><a href="../../../../../../userGuide/struts-html.html#text">text</a> + <li><a href="../../../../../../tagreference.html#text">text</a> input fields</li> - <li><a href="../../../../../../userGuide/struts-html.html#textarea">textareas</a> + <li><a href="../../../../../../tagreference.html#textarea">textareas</a> </li> </ul> @@ -372,7 +372,7 @@ <p> </p> -<p>See the <a href="../../../../../../userGuide/struts-html.html">HTML Tags +<p>See the <a href="../../../../../../tagreference.html">HTML Tags Reference</a> for detailed information about the available tags in this tag library, and the complete list of valid attributes for each tag.</p> @@ -533,7 +533,7 @@ </h4> <ul> - <li><a href="../../../../../../userGuide/struts-html.html#base">base</a> + <li><a href="../../../../../../tagreference.html#base">base</a> </li> </ul> @@ -572,14 +572,14 @@ it easy to write "session-aware" hyperlink references:</p> <ul> - <li><a href="../../../../../../userGuide/struts-html.html#link">link</a> + <li><a href="../../../../../../tagreference.html#link">link</a> - Renders an HTML anchor or hyperlink.</li> <li> - <a href="../../../../../../userGuide/struts-html.html#rewrite">rewrite</a> + <a href="../../../../../../tagreference.html#rewrite">rewrite</a> - Renders a request URI, but without creating the <a> hyperlink. This tag is useful when you want to generate a string constant for use by a JavaScript procedure.</li> - <li><a href="../../../../../../userGuide/struts-html.html#img">img</a> + <li><a href="../../../../../../tagreference.html#img">img</a> - Renders an HTML <img> element with the image at the specified URL.</li> @@ -837,7 +837,7 @@ </table> </p> -<p>See the <a href="../../../../../../userGuide/struts-html.html">HTML Tags +<p>See the <a href="../../../../../../tagreference.html">HTML Tags Reference</a> for the complete list of valid attributes for each tag.. </p> @@ -847,31 +847,31 @@ <p>Internationalization is automatically supported by the HTML tags where appropriate. </p> -<p><a href="../../../../../../userGuide/struts-html.html#errors">Errors</a> +<p><a href="../../../../../../tagreference.html#errors">Errors</a> - By default, the text for your messages will be returned by the default message resource, which will select the appropriate language for the user. You may also specify another message resource using the <code> bundle</code> attribute.</p> -<p><a href="../../../../../../userGuide/struts-html.html#html">HTML</a> +<p><a href="../../../../../../tagreference.html#html">HTML</a> - Renders an HTML element with language attributes extracted from the user's current Locale object, if there is one. </p> -<p><a href="../../../../../../userGuide/struts-html.html#image">image</a> - and <a href="../../../../../../userGuide/struts-html.html#img">img</a> +<p><a href="../../../../../../tagreference.html#image">image</a> + and <a href="../../../../../../tagreference.html#img">img</a> - Can optionally retrieve the value for its binary source and alt text from the message resource, so that different images and/or text can be provided for different locales. See the tag's <code>altKey</code>, <code> srcKey</code> , and <code>bundle</code> attributes in the <a - href="../../../../../../userGuide/struts-html.html"> + href="../../../../../../tagreference.html"> HTML Tags Reference</a> .</p> <p> - <a href="../../../../../../userGuide/struts-html.html#messages">Messages</a> + <a href="../../../../../../tagreference.html#messages">Messages</a> - By default, the text for your messages will be returned by the default message resource, which will select the appropriate language for the user. You may also specify another message resource using the <code> Modified: struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/logic/package.html URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/logic/package.html?rev=421008&r1=421007&r2=421008&view=diff ============================================================================== --- struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/logic/package.html (original) +++ struts/struts1/trunk/taglib/src/main/java/org/apache/struts/taglib/logic/package.html Tue Jul 11 15:03:41 2006 @@ -43,16 +43,16 @@ body of the tag if the comparison evaluates to <i>true. </i></p> <ul> - <li><b><a href="../../../../../../userGuide/struts-logic.html#equal">equal,</a> - <a href="../../../../../../userGuide/struts-logic.html#notEqual">notEqual</a> + <li><b><a href="../../../../../../tagreference.html#equal">equal,</a> + <a href="../../../../../../tagreference.html#notEqual">notEqual</a> </b></li> <li><b><a - href="../../../../../../userGuide/struts-logic.html#greaterEqual">greaterEqual</a> - , <a href="../../../../../../userGuide/struts-logic.html#lessEqual">lessEqual</a> + href="../../../../../../tagreference.html#greaterEqual">greaterEqual</a> + , <a href="../../../../../../tagreference.html#lessEqual">lessEqual</a> </b></li> <li><b><a - href="../../../../../../userGuide/struts-logic.html#greaterThan">greaterThan</a> - ,<a href="../../../../../../userGuide/struts-logic.html#lessThan"> + href="../../../../../../tagreference.html#greaterThan">greaterThan</a> + ,<a href="../../../../../../tagreference.html#lessThan"> lessThan</a> </b></li> @@ -64,8 +64,8 @@ <ul> <li><b><a - href="../../../../../../userGuide/struts-logic.html#match">match</a> - , <a href="../../../../../../userGuide/struts-logic.html#notMatch">notMatch</a> + href="../../../../../../tagreference.html#match">match</a> + , <a href="../../../../../../tagreference.html#notMatch">notMatch</a> </b></li> </ul> @@ -74,9 +74,9 @@ the location of the presentation page</p> <ul> - <li><a href="../../../../../../userGuide/struts-logic.html#forward"><b>forward</b></a> + <li><a href="../../../../../../tagreference.html#forward"><b>forward</b></a> </li> - <li><a href="../../../../../../userGuide/struts-logic.html#redirect"><b>redirect</b></a> + <li><a href="../../../../../../tagreference.html#redirect"><b>redirect</b></a> </li> </ul> @@ -85,7 +85,7 @@ Collections</p> <ul> - <li><a href="../../../../../../userGuide/struts-logic.html#iterate"><b>iterate</b></a> + <li><a href="../../../../../../tagreference.html#iterate"><b>iterate</b></a> </li> </ul> Modified: struts/struts1/trunk/taglib/src/main/resources/META-INF/tld/struts-html.tld URL: http://svn.apache.org/viewvc/struts/struts1/trunk/taglib/src/main/resources/META-INF/tld/struts-html.tld?rev=421008&r1=421007&r2=421008&view=diff ============================================================================== --- struts/struts1/trunk/taglib/src/main/resources/META-INF/tld/struts-html.tld (original) +++ struts/struts1/trunk/taglib/src/main/resources/META-INF/tld/struts-html.tld Tue Jul 11 15:03:41 2006 @@ -744,7 +744,7 @@ <code>ActionForm</code> bean associated with this form must include a statement setting the corresponding boolean property to <code>false</code> in the - <code>reset()</code> method.</p> + <code>reset()</code> method.</p> ]]> </description> <attribute> @@ -2115,10 +2115,10 @@ <code>href</code> attribute, or the <code>page</code> attribute.</p> - <p>Additionally, you can specify a <code>module</code> prefix - for linking to other modules.</p> - - ]]> + <p>Additionally, you can specify a <code>module</code> prefix + for linking to other modules.</p> + + ]]> </description> </attribute> <attribute> @@ -2127,14 +2127,14 @@ <rtexprvalue>true</rtexprvalue> <description> <![CDATA[ - <p>Prefix name of a <code>Module</code> that - contains the action mapping for the <code>Action</code> - that is specified by the <code>action</code> attribute. - You <strong>must</strong> specify an <code>action</code> - attribute for this to have an effect.</p> - - <p><strong>Note: </strong>Use "" to map to the default module.</p> - ]]> + <p>Prefix name of a <code>Module</code> that + contains the action mapping for the <code>Action</code> + that is specified by the <code>action</code> attribute. + You <strong>must</strong> specify an <code>action</code> + attribute for this to have an effect.</p> + + <p><strong>Note: </strong>Use "" to map to the default module.</p> + ]]> </description> </attribute> <attribute> @@ -3647,10 +3647,10 @@ <code>page</code> attribute or the <code>src</code> attribute.</p> - <p>Additionally, you can specify a <code>module</code> prefix - for linking to other modules.</p> - - ]]> + <p>Additionally, you can specify a <code>module</code> prefix + for linking to other modules.</p> + + ]]> </description> </attribute> <attribute> @@ -3659,14 +3659,14 @@ <rtexprvalue>true</rtexprvalue> <description> <![CDATA[ - <p>Prefix name of a <code>Module</code> that - contains the action mapping for the <code>Action</code> - that is specified by the <code>action</code> attribute. - You <strong>must</strong> specify an <code>action</code> - attribute for this to have an effect.</p> - - <p><strong>Note: </strong>Use "" to map to the default module.</p> - ]]> + <p>Prefix name of a <code>Module</code> that + contains the action mapping for the <code>Action</code> + that is specified by the <code>action</code> attribute. + You <strong>must</strong> specify an <code>action</code> + attribute for this to have an effect.</p> + + <p><strong>Note: </strong>Use "" to map to the default module.</p> + ]]> </description> </attribute> <attribute> @@ -4177,10 +4177,10 @@ <code>href</code> attribute, the <code>linkName</code> attribute, or the <code>page</code> attribute.</p> - <p>Additionally, you can specify a <code>module</code> prefix - for linking to other modules.</p> - - ]]> + <p>Additionally, you can specify a <code>module</code> prefix + for linking to other modules.</p> + + ]]> </description> </attribute> <attribute> @@ -4189,14 +4189,14 @@ <rtexprvalue>true</rtexprvalue> <description> <![CDATA[ - <p>Prefix name of a <code>Module</code> that - contains the action mapping for the <code>Action</code> - that is specified by the <code>action</code> attribute. - You <strong>must</strong> specify an <code>action</code> - attribute for this to have an effect.</p> - - <p><strong>Note: </strong>Use "" to map to the default module.</p> - ]]> + <p>Prefix name of a <code>Module</code> that + contains the action mapping for the <code>Action</code> + that is specified by the <code>action</code> attribute. + You <strong>must</strong> specify an <code>action</code> + attribute for this to have an effect.</p> + + <p><strong>Note: </strong>Use "" to map to the default module.</p> + ]]> </description> </attribute> <attribute> @@ -4811,6 +4811,11 @@ body content of this tag will be used as the value to be returned.</li> </ul> + + <p> + Also note that a map backed attribute cannot be used to hold a the String[] + for a group of multibox tags. + </p> ]]> </description> @@ -6844,10 +6849,10 @@ <code>href</code> attribute, or the <code>page</code> attribute.</p> - <p>Additionally, you can specify a <code>module</code> prefix - for linking to other modules.</p> - - + <p>Additionally, you can specify a <code>module</code> prefix + for linking to other modules.</p> + + <dl><dt><b>Since:</b></dt> <dd>Struts 1.2.0</dd></dl> ]]> @@ -6859,14 +6864,14 @@ <rtexprvalue>true</rtexprvalue> <description> <![CDATA[ - <p>Prefix name of a <code>Module</code> that - contains the action mapping for the <code>Action</code> - that is specified by the <code>action</code> attribute. - You <strong>must</strong> specify an <code>action</code> - attribute for this to have an effect.</p> - - <p><strong>Note: </strong>Use "" to map to the default module.</p> - ]]> + <p>Prefix name of a <code>Module</code> that + contains the action mapping for the <code>Action</code> + that is specified by the <code>action</code> attribute. + You <strong>must</strong> specify an <code>action</code> + attribute for this to have an effect.</p> + + <p><strong>Note: </strong>Use "" to map to the default module.</p> + ]]> </description> </attribute> <attribute> @@ -8741,9 +8746,9 @@ tag has no attributes; you use it like this: <html:xhtml/>. </p> <p> - <strong>Note</strong>: Included pages do not inherit the rendering - style of the including page. Each JSP fragment or Tile must use this - tag to render as XHTML. + <strong>Note</strong>: Included pages do not inherit the rendering + style of the including page. Each JSP fragment or Tile must use this + tag to render as XHTML. </p> ]]> </description>