You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by Mark Roth <ma...@sun.com> on 2002/10/04 00:08:44 UTC
[PATCH] jakarta-servletapi-5: javadocs, API changes and new file

NEW FILE (in jakarta-servletapi-5.newfiles.tar):
     - jsr154/src/share/dtd/j2ee_web_services_1_1.xsd
       (Required by latest j2ee_1_4.xsd)


CHANGED FILES:

jsr152/src/share/javax/servlet/jsp/JspContext.java:
     - getAttribute(name): Remove IllegalArgumentException
       for non-existent scope parameter.
     - Added javadoc for IllegalArgumentException for
       removeAttribute(name, scope)
     - Added javadoc for IllegalArgumentException for
       getAttributeNamesInScope(scope)
     - Added 'public JspWriter pushBody( java.io.Writer writer );'
     - Moved 'public JspWriter popBody()' from PageContext to JspContext.

jsr152/src/share/javax/servlet/jsp/PageContext.java:
     - forward(path): Remove IllegalArgumentException and
       SecurityException, which are not declared in the RequestDispatcher
       counterpart methods.
     - include(path): Remove IllegalArgumentException and
       SecurityException, which are not declared in the RequestDispatcher
       counterpart methods.
     - include(path, flush): Remove IllegalArgumentException and
       SecurityException, which are not declared in the RequestDispatcher
       counterpart methods.
     - Moved 'public JspWriter popBody()' from PageContext to JspContext.

jsr152/src/share/javax/servlet/jsp/el/ELException.java:
     - Removed toString() method, and constructors pass in localized
       message of root cause Throwable.

jsr152/src/share/javax/servlet/jsp/el/VariableResolver.java:
     - resolveVariable( name, context ): Add description for
       context parameter.

jsr152/src/share/javax/servlet/jsp/el/ExpressionEvaluator.java:
     - Elaborate on description of what should be passed for the
       expression parameter.  The expression parameter includes
       the tokens '${' and '}', which can appear more than once.
       For example, parseExpression( "Version ${major}.${minor}", ... )
       is valid.
     - Elaborate on caller requirements for passing in a FunctionMapper
       to evaluate() and parseExpression().

jsr152/src/share/dtd/web-jsptaglibrary_2_0.xsd:
     - Escape markup in documentation with CDATA instead of &lt;

jsr154/src/share/dtd/web-jsptaglibrary_2_0.xsd:
     - Escape markup in documentation with CDATA instead of &lt;

jsr154/src/share/dtd/j2ee_1_4.xsd:
     - Escape markup in documentation with CDATA instead of &lt;
     - Make CDATA sections use a consistent style
     - Make xsd:include schemaLocation point to IBM site

jsr154/src/share/dtd/web-app_2_4.xsd:
     - Escape markup in documentation with CDATA instead of &lt;
     - Added ERROR to list of legal values for request dispatcher


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

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