You are viewing a plain text version of this content. The canonical link for it is here.
Posted to servletapi-dev@jakarta.apache.org by ed...@locus.apache.org on 2000/10/14 01:13:41 UTC
cvs commit: jakarta-servletapi/src/share/javax/servlet/jsp/tagext BodyTag.java BodyTagSupport.java Tag.java TagAttributeInfo.java TagSupport.java VariableInfo.java
eduardop 00/10/13 16:13:41
Modified: src/share/javax/servlet/jsp/tagext Tag: SERVLET_23_JSP_12
BodyTag.java BodyTagSupport.java Tag.java
TagAttributeInfo.java TagSupport.java
VariableInfo.java
Log:
Added editorial feedback from reviewers
Revision Changes Path
No revision
No revision
1.1.1.1.4.2 +7 -4 jakarta-servletapi/src/share/javax/servlet/jsp/tagext/BodyTag.java
Index: BodyTag.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/tagext/BodyTag.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- BodyTag.java 2000/08/24 21:05:28 1.1.1.1.4.1
+++ BodyTag.java 2000/10/13 23:13:39 1.1.1.1.4.2
@@ -78,11 +78,14 @@
*
* <p>
* If EVAL_BODY_BUFFERED is returned, then a BodyContent object will be
- * created to capture the body evaluation. This object is obtained by
+ * created (by code generated by the JSP compiler) to capture the body
+ * evaluation.
+ * The code generated by the JSP compiler obtains the BodyContent object by
* calling the pushBody method of the current pageContext, which
- * additionally has the effect of saving the previous out value. The
- * object is returned through a call to the popBody method of the
- * PageContext class; the call also restores the value of out.
+ * additionally has the effect of saving the previous out value.
+ * The page compiler returns this object by calling the popBody
+ * method of the PageContext class;
+ * the call also restores the value of out.
*
* <p>
* The interface provides one new property with a setter method and one
1.1.1.1.4.2 +1 -1 jakarta-servletapi/src/share/javax/servlet/jsp/tagext/BodyTagSupport.java
Index: BodyTagSupport.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/tagext/BodyTagSupport.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- BodyTagSupport.java 2000/08/24 21:05:28 1.1.1.1.4.1
+++ BodyTagSupport.java 2000/10/13 23:13:39 1.1.1.1.4.2
@@ -72,7 +72,7 @@
* bodyContent property and methods to get at the previous out JspWriter.
*
* <p>
- * Many tag handlers will extend TagSupport and only redefine a few tags.
+ * Many tag handlers will extend TagSupport and only redefine a few methods.
*/
public class BodyTagSupport extends TagSupport implements BodyTag {
1.1.1.1.4.2 +3 -2 jakarta-servletapi/src/share/javax/servlet/jsp/tagext/Tag.java
Index: Tag.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/tagext/Tag.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- Tag.java 2000/08/24 21:05:29 1.1.1.1.4.1
+++ Tag.java 2000/10/13 23:13:40 1.1.1.1.4.2
@@ -143,7 +143,9 @@
* prior to doStartTag().
* <p>
* This value is *not* reset by doEndTag() and must be explicitly reset
- * by a page implementation
+ * by a page implementation if it changes between calls to doStartTag().
+ *
+ * @param pc The page context for this tag handler.
*/
void setPageContext(PageContext pc);
@@ -169,7 +171,6 @@
* This method is used by the findAncestorWithClass() method in
* TagSupport.
*
- * @param t The enclosing tag handler.
* @returns the current parent, or null if none.
* @seealso TagSupport.findAncestorWithClass().
*/
1.1.1.1.4.2 +4 -4 jakarta-servletapi/src/share/javax/servlet/jsp/tagext/TagAttributeInfo.java
Index: TagAttributeInfo.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/tagext/TagAttributeInfo.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- TagAttributeInfo.java 2000/08/24 21:05:29 1.1.1.1.4.1
+++ TagAttributeInfo.java 2000/10/13 23:13:40 1.1.1.1.4.2
@@ -78,10 +78,10 @@
* TagLibrary code under request from some JSP code that is parsing a
* TLD (Tag Library Descriptor).
*
- * @param name The name of the attribute
- * @param required If this attribute is required in tag instances
- * @param type The name of the type of the attribute
- * @param reqTime Whether this attribute hold a request-time Attribute
+ * @param name The name of the attribute.
+ * @param required If this attribute is required in tag instances.
+ * @param type The name of the type of the attribute.
+ * @param reqTime Whether this attribute holds a request-time Attribute.
*/
public TagAttributeInfo(String name, boolean required,
1.1.1.1.4.2 +3 -3 jakarta-servletapi/src/share/javax/servlet/jsp/tagext/TagSupport.java
Index: TagSupport.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/tagext/TagSupport.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- TagSupport.java 2000/08/24 21:05:31 1.1.1.1.4.1
+++ TagSupport.java 2000/10/13 23:13:40 1.1.1.1.4.2
@@ -66,7 +66,7 @@
import java.util.Enumeration;
/**
- * A base class for defnining new tag handlers implementing Tag.
+ * A base class for defining new tag handlers implementing Tag.
*
* <p> The TagSupport class is a utility class intended to be used as
* the base class for new tag handlers. The TagSupport class
@@ -76,7 +76,7 @@
* facilitate coordination among cooperating tags.
*
* <p> Many tag handlers will extend TagSupport and only redefine a
- * few tags.
+ * few methods.
*/
public class TagSupport implements IterationTag, Serializable {
@@ -120,7 +120,7 @@
}
/**
- * Default constructor, all subclasses are required to only define
+ * Default constructor, all subclasses are required to define only
* a public constructor with the same signature, and to call the
* superclass constructor.
*
1.1.1.1.4.2 +6 -7 jakarta-servletapi/src/share/javax/servlet/jsp/tagext/VariableInfo.java
Index: VariableInfo.java
===================================================================
RCS file: /home/cvs/jakarta-servletapi/src/share/javax/servlet/jsp/tagext/VariableInfo.java,v
retrieving revision 1.1.1.1.4.1
retrieving revision 1.1.1.1.4.2
diff -u -r1.1.1.1.4.1 -r1.1.1.1.4.2
--- VariableInfo.java 2000/08/24 21:05:31 1.1.1.1.4.1
+++ VariableInfo.java 2000/10/13 23:13:40 1.1.1.1.4.2
@@ -61,8 +61,8 @@
* classes and it is used by the translation phase of JSP.
*
* <p>
- * Scripting variables generated by a custom action may have scope
- * page, request, session, and application.
+ * Scripting variables generated by a custom action may have scope values
+ * of page, request, session, and application.
*
* <p>
* The class name (VariableInfo.getClassName) in the returned objects
@@ -96,9 +96,9 @@
* <p>
* Frequently a fully qualified class name will refer to a class that
* is known to the tag library and thus, delivered in the same JAR
- * file as the tag handlers. In almost other remaining cases it will
+ * file as the tag handlers. In most other remaining cases it will
* refer to a class that is in the platform on which the JSP processor
- * is build (like J2EE). Using fully qualified class names in this
+ * is built (like J2EE). Using fully qualified class names in this
* manner makes the usage relatively resistant to configuration
* errors.
*
@@ -116,7 +116,7 @@
* VariableInfo objects. Each such object describes a scripting
* variable by providing its name, its type, whether the variable is
* new or not, and what its scope is. Scope is best described through
- * a picture:.
+ * a picture:
*
* <p>
* <IMG src="doc-images/VariableInfo-1.gif"/>
@@ -135,8 +135,7 @@
* </ul>
*
* The scope value for a variable implies what methods may affect its
- * value and thus, in lack of additional information, where
- * synchronization is needed:
+ * value and thus where synchronization is needed:
*
* <ul>
* <li>