[PATCH] jakarta-servletapi-5 Clarification to IterationTag

[Mark Roth]

jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java
    - Clarified that doAfterBody() is not called if there is no body.

---
Mark Roth, Java Software
JSP 2.0 Co-Specification Lead
Sun Microsystems, Inc.

Index: jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java
===================================================================
RCS file: 
/home/cvspublic/jakarta-servletapi-5/jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java,v
retrieving revision 1.6
diff -u -r1.6 IterationTag.java
--- jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java 31 Mar 2003 17:52:26 
-0000      1.6
+++ jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java 3 Sep 2003 19:53:38 
-0000
@@ -91,21 +91,23 @@
  *
  * <p><B>Empty and Non-Empty Action</B>
  * <p> If the TagLibraryDescriptor file indicates that the action must
- * always have an empty action, by an &lt;body-content&gt; entry of "empty",
- * then the doStartTag() method must return SKIP_BODY.
+ * always have an empty element body, by a &lt;body-content&gt; entry of 
+ * "empty", then the doStartTag() method must return SKIP_BODY.
  *
- * Otherwise, the doStartTag() method may return SKIP_BODY or
- * EVAL_BODY_INCLUDE.
+ * <p>Note that which methods are invoked after the doStartTag() depends on
+ * both the return value and on if the custom action element is empty
+ * or not in the JSP page, not on how it's declared in the TLD.
  *
  * <p>
  * If SKIP_BODY is returned the body is not evaluated, and then doEndTag()
  * is invoked.
  *
  * <p>
- * If EVAL_BODY_INCLUDE is returned, the body is evaluated and
- * "passed through" to the current out, then doAfterBody() is invoked
- * and, after zero or more iterations, doEndTag() is invoked.
-*/
+ * If EVAL_BODY_INCLUDE is returned, and the custom action element is not
+ * empty, the body is evaluated and "passed through" to the current out, 
+ * then doAfterBody() is invoked and, after zero or more iterations, 
+ * doEndTag() is invoked.
+ */
 
 public interface IterationTag extends Tag {
 


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]