svn commit: r399393 - /beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java

[ek...@apache.org]

Author: ekoneil
Date: Wed May  3 13:02:58 2006
New Revision: 399393

URL: http://svn.apache.org/viewcvs?rev=399393&view=rev
Log:
Update the Javadoc on the BindingUpdateErrors tag to reflect its relation to NetUI expressions.

BB: self
Test: NetUI pass


Modified:
    beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java

Modified: beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java
URL: http://svn.apache.org/viewcvs/beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java?rev=399393&r1=399392&r2=399393&view=diff
==============================================================================
--- beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java (original)
+++ beehive/trunk/netui/src/tags-html/org/apache/beehive/netui/tags/html/BindingUpdateErrors.java Wed May  3 13:02:58 2006
@@ -36,18 +36,30 @@
  * warnings.  By default, this tag is only on in Iterative Dev mode and
  * the warning are not displayed in production mode.  The tag is intended
  * for development use.
- * @jsptagref.tagdescription Renders the set of error messages found during the process of resolving
- * data binding expressions (${pageFlow.firstname}, ${requestScope.firstname}, etc.).
- * The tag is intended
- * for development use, not for error reporting in deployed applications.
- * @example In this first sample, because the <netui:bindingUpdateErrors/> tag is unqualified,
+ * @jsptagref.tagdescription
+ * Renders the set of error messages found during the process of resolving
+ * data binding expressions (pageFlow.firstname, requestScope.firstname, etc.).
+ * The tag is intended for development use and not for error reporting in deployed applications.  When the
+ * NetUI framework is not in development mode, this tag will do nothing.
+ *
+ * @example
+ * <p>
+ * In this first sample, because the &lt;netui:bindingUpdateErrors/> tag is unqualified,
  * messages will be displayed if <b>any</b> data binding errors occurred when a form was
  * posted. The messages are displayed on the page and the command window.
+ * </p>
  * <pre>&lt;netui:bindingUpdateErrors /></pre>
- * <p>In this next sample, only binding errors for the expression <code>{actionForm.firstName}</code>
- * will be displayed on the page and the command window. </p>
- * <pre>&lt;netui:bindingUpdateErrors expression="${actionForm.firstName}"/></pre>
- * @netui:tag name="bindingUpdateErrors" body-content="empty" description="Will display a message for all binding update errors that occurred when a form was posted."
+ * <p>
+ * In this next sample, only binding errors for the expression <code>{actionForm.firstName}</code>
+ * will be displayed on the page and the command window.
+ * </p>
+ * <pre>&lt;netui:bindingUpdateErrors expression="actionForm.firstName"/></pre>
+ * <p>
+ * Note, the expression used in this tag needs to match the expressions used to POST form data.  This
+ * tag's <code>expression</code> attribute must resolve to a valid NetUI expression.
+ * </p>
+ * @netui:tag name="bindingUpdateErrors" body-content="empty"
+ *            description="Will display a message for all binding update errors that occurred when a form was posted."
  */
 public class BindingUpdateErrors extends AbstractSimpleTag
 {
@@ -67,8 +79,8 @@
      * is set, only binding errors for that expression will be displayed.
      * Otherwise, all errors will be displayed.
      * @param expression The expression to match against.
-     * @jsptagref.attributedescription String. The data binding expression to match for binding errors.  If a data binding expression
-     * is specified, only binding errors for that expression will be displayed.
+     * @jsptagref.attributedescription String. The data binding expression to match for binding errors.
+     * If a data binding expression is specified, only binding errors for that expression will be displayed.
      * Otherwise, all errors will be displayed.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_databinding_expression</i>