[PATCH] jakarta-servletapi-5: javadoc clarifications

[Mark Roth <ma...@sun.com>]

Here is a patch with some more javadoc clarifications, to make the API 
more testable.  Thanks go to Ryan Lubke for helping out!

As always, please let me know if there are any questions or concerns.

Change summary:
---------------

jsr152/src/share/javax/servlet/jsp/tagext/VariableInfo.java
   - Fixed incorrect wording from last patch, for variable
     synchronization.

jsr152/src/share/javax/servlet/jsp/tagext/TagExtraInfo.java
   - Fixed wording to preserve forwards compatibility for existing TEI
     implementations.

jsr152/src/share/javax/servlet/jsp/tagext/TagInfo.java
   - Fixed default implementation of getVariableInfo() to return a
     variable for the id attribute, if specified.
     Clarified intent in javadocs.

jsr152/src/share/javax/servlet/jsp/tagext/TagData.java
   - Fixed getId() description, as we're not returning the jsp:id in this
     case.

jsr152/src/share/javax/servlet/jsp/tagext/BodyTag.java
jsr152/src/share/javax/servlet/jsp/tagext/IterationTag.java
jsr152/src/share/javax/servlet/jsp/tagext/SimpleTag.java
jsr152/src/share/javax/servlet/jsp/tagext/Tag.java
   - Clarified javadocs w.r.t. variable synchronization

jsr152/src/share/dtd/web-jsptaglibrary_2_0.xsd
jsr154/src/share/dtd/web-jsptaglibrary_2_0.xsd
   - Removed fragment element under variable element, as fragment-scoped
     variables are no longer supported.

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