You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2021/10/12 07:03:12 UTC
[tomcat] branch main updated: Clarify @since tags. Add missins
@since tags.
This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/main by this push:
new fa64c16 Clarify @since tags. Add missins @since tags.
fa64c16 is described below
commit fa64c162a505bf36c0335d713dea5606f9185dc2
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Tue Oct 12 08:02:30 2021 +0100
Clarify @since tags. Add missins @since tags.
---
java/jakarta/el/MethodReference.java | 2 ++
java/jakarta/servlet/FilterChain.java | 2 --
java/jakarta/servlet/ServletContext.java | 2 +-
java/jakarta/servlet/ServletContextAttributeEvent.java | 2 +-
java/jakarta/servlet/ServletContextAttributeListener.java | 2 +-
java/jakarta/servlet/ServletContextEvent.java | 2 +-
java/jakarta/servlet/ServletContextListener.java | 2 +-
java/jakarta/servlet/ServletResponse.java | 6 +++---
java/jakarta/servlet/ServletResponseWrapper.java | 6 +++---
.../servlet/descriptor/JspPropertyGroupDescriptor.java | 2 ++
java/jakarta/servlet/http/HttpServlet.java | 2 +-
java/jakarta/servlet/http/HttpServletMapping.java | 2 +-
java/jakarta/servlet/http/HttpServletRequestWrapper.java | 2 +-
java/jakarta/servlet/http/HttpServletResponseWrapper.java | 2 +-
java/jakarta/servlet/http/HttpSession.java | 2 +-
.../servlet/http/HttpSessionActivationListener.java | 2 +-
.../jakarta/servlet/http/HttpSessionAttributeListener.java | 2 +-
java/jakarta/servlet/http/HttpSessionBindingEvent.java | 2 +-
java/jakarta/servlet/http/HttpSessionEvent.java | 2 +-
java/jakarta/servlet/http/HttpSessionListener.java | 2 +-
java/jakarta/servlet/http/MappingMatch.java | 2 +-
java/jakarta/servlet/jsp/ErrorData.java | 2 +-
java/jakarta/servlet/jsp/JspApplicationContext.java | 2 +-
java/jakarta/servlet/jsp/JspContext.java | 8 ++++----
java/jakarta/servlet/jsp/JspFactory.java | 2 +-
java/jakarta/servlet/jsp/JspTagException.java | 4 ++--
java/jakarta/servlet/jsp/PageContext.java | 4 ++--
java/jakarta/servlet/jsp/SkipPageException.java | 2 +-
java/jakarta/servlet/jsp/el/ELException.java | 2 +-
java/jakarta/servlet/jsp/el/ELParseException.java | 2 +-
java/jakarta/servlet/jsp/el/Expression.java | 2 +-
java/jakarta/servlet/jsp/el/ExpressionEvaluator.java | 2 +-
java/jakarta/servlet/jsp/el/FunctionMapper.java | 2 +-
java/jakarta/servlet/jsp/el/ImplicitObjectELResolver.java | 2 +-
java/jakarta/servlet/jsp/el/ScopedAttributeELResolver.java | 6 +++---
java/jakarta/servlet/jsp/el/VariableResolver.java | 2 +-
java/jakarta/servlet/jsp/tagext/DynamicAttributes.java | 2 +-
java/jakarta/servlet/jsp/tagext/FunctionInfo.java | 2 +-
java/jakarta/servlet/jsp/tagext/JspFragment.java | 2 +-
java/jakarta/servlet/jsp/tagext/JspTag.java | 2 +-
java/jakarta/servlet/jsp/tagext/SimpleTag.java | 2 +-
java/jakarta/servlet/jsp/tagext/SimpleTagSupport.java | 2 +-
java/jakarta/servlet/jsp/tagext/TagAdapter.java | 2 +-
java/jakarta/servlet/jsp/tagext/TagAttributeInfo.java | 4 ++--
java/jakarta/servlet/jsp/tagext/TagExtraInfo.java | 2 +-
java/jakarta/servlet/jsp/tagext/TagFileInfo.java | 2 +-
java/jakarta/servlet/jsp/tagext/TagInfo.java | 8 ++++----
java/jakarta/servlet/jsp/tagext/TagLibraryInfo.java | 14 +++++++-------
java/jakarta/websocket/server/ServerContainer.java | 2 ++
java/jakarta/websocket/server/ServerEndpointConfig.java | 2 ++
50 files changed, 74 insertions(+), 68 deletions(-)
diff --git a/java/jakarta/el/MethodReference.java b/java/jakarta/el/MethodReference.java
index c2ae338..ed59a84 100644
--- a/java/jakarta/el/MethodReference.java
+++ b/java/jakarta/el/MethodReference.java
@@ -21,6 +21,8 @@ import java.util.Arrays;
/**
* Provides information about the method to which a method expression resolves.
+ *
+ * @since EL 5.0
*/
public class MethodReference {
diff --git a/java/jakarta/servlet/FilterChain.java b/java/jakarta/servlet/FilterChain.java
index 86d3f30..535853f 100644
--- a/java/jakarta/servlet/FilterChain.java
+++ b/java/jakarta/servlet/FilterChain.java
@@ -44,8 +44,6 @@ public interface FilterChain {
* @throws IOException if an I/O error occurs during the processing of the
* request
* @throws ServletException if the processing fails for any other reason
-
- * @since 2.3
*/
public void doFilter(ServletRequest request, ServletResponse response)
throws IOException, ServletException;
diff --git a/java/jakarta/servlet/ServletContext.java b/java/jakarta/servlet/ServletContext.java
index fcac8be..c4ff7db 100644
--- a/java/jakarta/servlet/ServletContext.java
+++ b/java/jakarta/servlet/ServletContext.java
@@ -696,7 +696,7 @@ public interface ServletContext {
* {@link ServletContextListener} defined in a TLD would not be able to
* use this method.
* @throws ServletException TODO
- * @since Servlet 3.
+ * @since Servlet 3.0
*/
public <T extends Filter> T createFilter(Class<T> c) throws ServletException;
diff --git a/java/jakarta/servlet/ServletContextAttributeEvent.java b/java/jakarta/servlet/ServletContextAttributeEvent.java
index 5141352..0149da5 100644
--- a/java/jakarta/servlet/ServletContextAttributeEvent.java
+++ b/java/jakarta/servlet/ServletContextAttributeEvent.java
@@ -21,7 +21,7 @@ package jakarta.servlet;
* the servlet context of a web application.
*
* @see ServletContextAttributeListener
- * @since v 2.3
+ * @since Servlet 2.3
*/
public class ServletContextAttributeEvent extends ServletContextEvent {
private static final long serialVersionUID = 1L;
diff --git a/java/jakarta/servlet/ServletContextAttributeListener.java b/java/jakarta/servlet/ServletContextAttributeListener.java
index ced5a7b..25e42ba 100644
--- a/java/jakarta/servlet/ServletContextAttributeListener.java
+++ b/java/jakarta/servlet/ServletContextAttributeListener.java
@@ -25,7 +25,7 @@ import java.util.EventListener;
* deployment descriptor for the web application.
*
* @see ServletContextAttributeEvent
- * @since v 2.3
+ * @since Servlet 2.3
*/
public interface ServletContextAttributeListener extends EventListener {
diff --git a/java/jakarta/servlet/ServletContextEvent.java b/java/jakarta/servlet/ServletContextEvent.java
index fe53f16..7cf5408 100644
--- a/java/jakarta/servlet/ServletContextEvent.java
+++ b/java/jakarta/servlet/ServletContextEvent.java
@@ -21,7 +21,7 @@ package jakarta.servlet;
* context of a web application.
*
* @see ServletContextListener
- * @since v 2.3
+ * @since Servlet 2.3
*/
public class ServletContextEvent extends java.util.EventObject {
diff --git a/java/jakarta/servlet/ServletContextListener.java b/java/jakarta/servlet/ServletContextListener.java
index 3468e8e..c5e33d4 100644
--- a/java/jakarta/servlet/ServletContextListener.java
+++ b/java/jakarta/servlet/ServletContextListener.java
@@ -25,7 +25,7 @@ import java.util.EventListener;
* deployment descriptor for the web application.
*
* @see ServletContextEvent
- * @since v 2.3
+ * @since Servlet 2.3
*/
public interface ServletContextListener extends EventListener {
diff --git a/java/jakarta/servlet/ServletResponse.java b/java/jakarta/servlet/ServletResponse.java
index e1cdd26..ad19476 100644
--- a/java/jakarta/servlet/ServletResponse.java
+++ b/java/jakarta/servlet/ServletResponse.java
@@ -95,7 +95,7 @@ public interface ServletResponse {
*
* @return a <code>String</code> specifying the content type, for example,
* <code>text/html; charset=UTF-8</code>, or null
- * @since 2.4
+ * @since Servlet 2.4
*/
public String getContentType();
@@ -174,7 +174,7 @@ public interface ServletResponse {
* Character Sets
* (http://www.iana.org/assignments/character-sets)
* @see #setContentType #setLocale
- * @since 2.4
+ * @since Servlet 2.4
*/
public void setCharacterEncoding(String charset);
@@ -288,7 +288,7 @@ public interface ServletResponse {
* @see #getBufferSize
* @see #isCommitted
* @see #reset
- * @since 2.3
+ * @since Servlet 2.3
*/
public void resetBuffer();
diff --git a/java/jakarta/servlet/ServletResponseWrapper.java b/java/jakarta/servlet/ServletResponseWrapper.java
index 449dea9..eb51194 100644
--- a/java/jakarta/servlet/ServletResponseWrapper.java
+++ b/java/jakarta/servlet/ServletResponseWrapper.java
@@ -27,7 +27,7 @@ import java.util.ResourceBundle;
* This class implements the Wrapper or Decorator pattern. Methods default to
* calling through to the wrapped response object.
*
- * @since v 2.3
+ * @since Servlet 2.3
* @see jakarta.servlet.ServletResponse
*/
public class ServletResponseWrapper implements ServletResponse {
@@ -80,7 +80,7 @@ public class ServletResponseWrapper implements ServletResponse {
* The default behavior of this method is to call
* setCharacterEncoding(String charset) on the wrapped response object.
*
- * @since 2.4
+ * @since Servlet 2.4
*/
@Override
public void setCharacterEncoding(String charset) {
@@ -147,7 +147,7 @@ public class ServletResponseWrapper implements ServletResponse {
* The default behavior of this method is to return getContentType() on the
* wrapped response object.
*
- * @since 2.4
+ * @since Servlet 2.4
*/
@Override
public String getContentType() {
diff --git a/java/jakarta/servlet/descriptor/JspPropertyGroupDescriptor.java b/java/jakarta/servlet/descriptor/JspPropertyGroupDescriptor.java
index afa6e8c..19b28ed 100644
--- a/java/jakarta/servlet/descriptor/JspPropertyGroupDescriptor.java
+++ b/java/jakarta/servlet/descriptor/JspPropertyGroupDescriptor.java
@@ -44,6 +44,8 @@ public interface JspPropertyGroupDescriptor {
* error for this group?
*
* @return {@code true} if an error will be triggered, otherwise {@code false}
+ *
+ * @since Servlet 6.0
*/
public String getErrorOnELNotFound();
diff --git a/java/jakarta/servlet/http/HttpServlet.java b/java/jakarta/servlet/http/HttpServlet.java
index f537321..31e4a9a 100644
--- a/java/jakarta/servlet/http/HttpServlet.java
+++ b/java/jakarta/servlet/http/HttpServlet.java
@@ -98,7 +98,7 @@ public abstract class HttpServlet extends GenericServlet {
/**
* @deprecated May be removed in a future release
*
- * @since 6.0
+ * @since Servlet 6.0
*/
@Deprecated
public static final String LEGACY_DO_HEAD = "jakarta.servlet.http.legacyDoHead";
diff --git a/java/jakarta/servlet/http/HttpServletMapping.java b/java/jakarta/servlet/http/HttpServletMapping.java
index 1b1e54d..7c31a89 100644
--- a/java/jakarta/servlet/http/HttpServletMapping.java
+++ b/java/jakarta/servlet/http/HttpServletMapping.java
@@ -22,7 +22,7 @@ import jakarta.servlet.annotation.WebServlet;
* Represents how the request from which this object was obtained was mapped to
* the associated servlet.
*
- * @since 4.0
+ * @since Servlet 4.0
*/
public interface HttpServletMapping {
diff --git a/java/jakarta/servlet/http/HttpServletRequestWrapper.java b/java/jakarta/servlet/http/HttpServletRequestWrapper.java
index 1125561..d9de9ad 100644
--- a/java/jakarta/servlet/http/HttpServletRequestWrapper.java
+++ b/java/jakarta/servlet/http/HttpServletRequestWrapper.java
@@ -31,7 +31,7 @@ import jakarta.servlet.ServletRequestWrapper;
* calling through to the wrapped request object.
*
* @see jakarta.servlet.http.HttpServletRequest
- * @since v 2.3
+ * @since Servlet 2.3
*/
public class HttpServletRequestWrapper extends ServletRequestWrapper implements
HttpServletRequest {
diff --git a/java/jakarta/servlet/http/HttpServletResponseWrapper.java b/java/jakarta/servlet/http/HttpServletResponseWrapper.java
index bc64609..edbdc4b 100644
--- a/java/jakarta/servlet/http/HttpServletResponseWrapper.java
+++ b/java/jakarta/servlet/http/HttpServletResponseWrapper.java
@@ -29,7 +29,7 @@ import jakarta.servlet.ServletResponseWrapper;
* Servlet. This class implements the Wrapper or Decorator pattern. Methods
* default to calling through to the wrapped response object.
*
- * @since v 2.3
+ * @since Servlet 2.3
* @see jakarta.servlet.http.HttpServletResponse
*/
public class HttpServletResponseWrapper extends ServletResponseWrapper
diff --git a/java/jakarta/servlet/http/HttpSession.java b/java/jakarta/servlet/http/HttpSession.java
index e712347..2883cdc 100644
--- a/java/jakarta/servlet/http/HttpSession.java
+++ b/java/jakarta/servlet/http/HttpSession.java
@@ -107,7 +107,7 @@ public interface HttpSession {
* Returns the ServletContext to which this session belongs.
*
* @return The ServletContext object for the web application
- * @since 2.3
+ * @since Servlet 2.3
*/
public ServletContext getServletContext();
diff --git a/java/jakarta/servlet/http/HttpSessionActivationListener.java b/java/jakarta/servlet/http/HttpSessionActivationListener.java
index 61cf840..97ed0f3 100644
--- a/java/jakarta/servlet/http/HttpSessionActivationListener.java
+++ b/java/jakarta/servlet/http/HttpSessionActivationListener.java
@@ -25,7 +25,7 @@ import java.util.EventListener;
* to notify all attributes bound to sessions implementing
* HttpSessionActivationListener.
*
- * @since 2.3
+ * @since Servlet 2.3
*/
public interface HttpSessionActivationListener extends EventListener {
diff --git a/java/jakarta/servlet/http/HttpSessionAttributeListener.java b/java/jakarta/servlet/http/HttpSessionAttributeListener.java
index d386c66..ec93d8a 100644
--- a/java/jakarta/servlet/http/HttpSessionAttributeListener.java
+++ b/java/jakarta/servlet/http/HttpSessionAttributeListener.java
@@ -22,7 +22,7 @@ import java.util.EventListener;
* This listener interface can be implemented in order to get notifications of
* changes to the attribute lists of sessions within this web application.
*
- * @since v 2.3
+ * @since Servlet 2.3
*/
public interface HttpSessionAttributeListener extends EventListener {
diff --git a/java/jakarta/servlet/http/HttpSessionBindingEvent.java b/java/jakarta/servlet/http/HttpSessionBindingEvent.java
index ed70b05..5b6b612 100644
--- a/java/jakarta/servlet/http/HttpSessionBindingEvent.java
+++ b/java/jakarta/servlet/http/HttpSessionBindingEvent.java
@@ -114,7 +114,7 @@ public class HttpSessionBindingEvent extends HttpSessionEvent {
* value of the removed attribute. If the attribute was replaced,
* this is the old value of the attribute.
*
- * @since 2.3
+ * @since Servlet 2.3
*/
public Object getValue() {
return this.value;
diff --git a/java/jakarta/servlet/http/HttpSessionEvent.java b/java/jakarta/servlet/http/HttpSessionEvent.java
index 1ee7c8d..0d536e5 100644
--- a/java/jakarta/servlet/http/HttpSessionEvent.java
+++ b/java/jakarta/servlet/http/HttpSessionEvent.java
@@ -20,7 +20,7 @@ package jakarta.servlet.http;
* This is the class representing event notifications for changes to sessions
* within a web application.
*
- * @since v 2.3
+ * @since Servlet 2.3
*/
public class HttpSessionEvent extends java.util.EventObject {
private static final long serialVersionUID = 1L;
diff --git a/java/jakarta/servlet/http/HttpSessionListener.java b/java/jakarta/servlet/http/HttpSessionListener.java
index 181d328..1f434d6 100644
--- a/java/jakarta/servlet/http/HttpSessionListener.java
+++ b/java/jakarta/servlet/http/HttpSessionListener.java
@@ -25,7 +25,7 @@ import java.util.EventListener;
* web application.
*
* @see HttpSessionEvent
- * @since v 2.3
+ * @since Servlet 2.3
*/
public interface HttpSessionListener extends EventListener {
diff --git a/java/jakarta/servlet/http/MappingMatch.java b/java/jakarta/servlet/http/MappingMatch.java
index 4a7fc77..239ee6a 100644
--- a/java/jakarta/servlet/http/MappingMatch.java
+++ b/java/jakarta/servlet/http/MappingMatch.java
@@ -19,7 +19,7 @@ package jakarta.servlet.http;
/**
* Represents the ways that a request can be mapped to a servlet
*
- * @since 4.0
+ * @since Servlet 4.0
*/
public enum MappingMatch {
diff --git a/java/jakarta/servlet/jsp/ErrorData.java b/java/jakarta/servlet/jsp/ErrorData.java
index 44f73cb..7ab0f12 100644
--- a/java/jakarta/servlet/jsp/ErrorData.java
+++ b/java/jakarta/servlet/jsp/ErrorData.java
@@ -23,7 +23,7 @@ package jakarta.servlet.jsp;
* isErrorPage attribute of the page directive to "true".
*
* @see PageContext#getErrorData
- * @since 2.0
+ * @since JSP 2.0
*/
public final class ErrorData {
diff --git a/java/jakarta/servlet/jsp/JspApplicationContext.java b/java/jakarta/servlet/jsp/JspApplicationContext.java
index 11886fe..5d05934 100644
--- a/java/jakarta/servlet/jsp/JspApplicationContext.java
+++ b/java/jakarta/servlet/jsp/JspApplicationContext.java
@@ -25,7 +25,7 @@ import jakarta.el.ExpressionFactory;
* Stores <i>application</i>-scoped information for the JSP container.
* </p>
*
- * @since 2.1
+ * @since JSP 2.1
*/
public interface JspApplicationContext {
diff --git a/java/jakarta/servlet/jsp/JspContext.java b/java/jakarta/servlet/jsp/JspContext.java
index 8c1ebc4..1959e57 100644
--- a/java/jakarta/servlet/jsp/JspContext.java
+++ b/java/jakarta/servlet/jsp/JspContext.java
@@ -64,7 +64,7 @@ import jakarta.el.ELContext;
* Expression Language evaluator:
* <code>getExpressionEvaluator()</code>, <code>getVariableResolver()</code>
*
- * @since 2.0
+ * @since JSP 2.0
*/
public abstract class JspContext {
@@ -220,7 +220,7 @@ public abstract class JspContext {
* ExpressionEvaluator that can parse EL expressions.
*
* @return A valid instance of an ExpressionEvaluator.
- * @since 2.0
+ * @since JSP 2.0
* @deprecated As of JSP 2.1, replaced by
* JspApplicationContext.getExpressionFactory()
*/
@@ -241,7 +241,7 @@ public abstract class JspContext {
* as the context object.
*
* @return A valid instance of a VariableResolver.
- * @since 2.0
+ * @since JSP 2.0
* @deprecated As of JSP 2.1,
* replaced by jakarta.el.ELContext.getELResolver()
* which can be obtained by
@@ -268,7 +268,7 @@ public abstract class JspContext {
* @param writer The Writer for the returned JspWriter to send
* output to.
* @return a new JspWriter that writes to the given Writer.
- * @since 2.0
+ * @since JSP 2.0
*/
public JspWriter pushBody( java.io.Writer writer ) {
return null; // XXX to implement
diff --git a/java/jakarta/servlet/jsp/JspFactory.java b/java/jakarta/servlet/jsp/JspFactory.java
index 11ec45f..1a91a16 100644
--- a/java/jakarta/servlet/jsp/JspFactory.java
+++ b/java/jakarta/servlet/jsp/JspFactory.java
@@ -150,7 +150,7 @@ public abstract class JspFactory {
*
* @param context the current web application's <code>ServletContext</code>
* @return <code>JspApplicationContext</code> instance
- * @since 2.1
+ * @since JSP 2.1
*/
public abstract JspApplicationContext getJspApplicationContext(
ServletContext context);
diff --git a/java/jakarta/servlet/jsp/JspTagException.java b/java/jakarta/servlet/jsp/JspTagException.java
index 1e6f642..e1064db 100644
--- a/java/jakarta/servlet/jsp/JspTagException.java
+++ b/java/jakarta/servlet/jsp/JspTagException.java
@@ -56,7 +56,7 @@ public class JspTagException extends JspException {
* the <code>Throwable</code> exception that interfered with the
* JSP Tag's normal operation, making this JSP Tag exception
* necessary
- * @since 2.0
+ * @since JSP 2.0
*/
public JspTagException(String message, Throwable rootCause) {
super(message, rootCause);
@@ -77,7 +77,7 @@ public class JspTagException extends JspException {
* the <code>Throwable</code> exception that interfered with the
* JSP Tag's normal operation, making the JSP Tag exception
* necessary
- * @since 2.0
+ * @since JSP 2.0
*/
public JspTagException(Throwable rootCause) {
super(rootCause);
diff --git a/java/jakarta/servlet/jsp/PageContext.java b/java/jakarta/servlet/jsp/PageContext.java
index 619b64e..391aa33 100644
--- a/java/jakarta/servlet/jsp/PageContext.java
+++ b/java/jakarta/servlet/jsp/PageContext.java
@@ -405,7 +405,7 @@ public abstract class PageContext
* @throws ServletException if the page that was forwarded to throws
* a ServletException
* @throws IOException if an I/O error occurred while forwarding
- * @since 2.0
+ * @since JSP 2.0
*/
public abstract void include(String relativeUrlPath, boolean flush)
throws ServletException, IOException;
@@ -508,7 +508,7 @@ public abstract class PageContext
* if the isErrorPage attribute of the page directive is not set
* to "true"), the information is meaningless.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public ErrorData getErrorData() {
int status = 0;
diff --git a/java/jakarta/servlet/jsp/SkipPageException.java b/java/jakarta/servlet/jsp/SkipPageException.java
index d3b89cb..971bad9 100644
--- a/java/jakarta/servlet/jsp/SkipPageException.java
+++ b/java/jakarta/servlet/jsp/SkipPageException.java
@@ -30,7 +30,7 @@ package jakarta.servlet.jsp;
* @see jakarta.servlet.jsp.tagext.SimpleTag#doTag
* @see jakarta.servlet.jsp.tagext.JspFragment#invoke
* @see jakarta.servlet.jsp.tagext.Tag#doEndTag
- * @since 2.0
+ * @since JSP 2.0
*/
public class SkipPageException extends JspException {
diff --git a/java/jakarta/servlet/jsp/el/ELException.java b/java/jakarta/servlet/jsp/el/ELException.java
index dc56f5e..455f9ba 100644
--- a/java/jakarta/servlet/jsp/el/ELException.java
+++ b/java/jakarta/servlet/jsp/el/ELException.java
@@ -20,7 +20,7 @@ package jakarta.servlet.jsp.el;
* Represents any of the exception conditions that arise during the operation
* evaluation of the evaluator.
*
- * @since 2.0
+ * @since JSP 2.0
* @deprecated As of JSP 2.1, replaced by jakarta.el.ELException
*/
@Deprecated
diff --git a/java/jakarta/servlet/jsp/el/ELParseException.java b/java/jakarta/servlet/jsp/el/ELParseException.java
index 75498b0..72a7ef1 100644
--- a/java/jakarta/servlet/jsp/el/ELParseException.java
+++ b/java/jakarta/servlet/jsp/el/ELParseException.java
@@ -20,7 +20,7 @@ package jakarta.servlet.jsp.el;
/**
* Represents a parsing error encountered while parsing an EL expression.
*
- * @since 2.0
+ * @since JSP 2.0
* @deprecated As of JSP 2.1, replaced by jakarta.el.ELException
*/
@Deprecated
diff --git a/java/jakarta/servlet/jsp/el/Expression.java b/java/jakarta/servlet/jsp/el/Expression.java
index e97cc4c..57d8811 100644
--- a/java/jakarta/servlet/jsp/el/Expression.java
+++ b/java/jakarta/servlet/jsp/el/Expression.java
@@ -27,7 +27,7 @@ package jakarta.servlet.jsp.el;
* A client invoking the evaluate() method should be ready for the case
* where ELParseException exceptions are raised. </p>
*
- * @since 2.0
+ * @since JSP 2.0
* @deprecated As of JSP 2.1, replaced by jakarta.el.ValueExpression
*/
@Deprecated
diff --git a/java/jakarta/servlet/jsp/el/ExpressionEvaluator.java b/java/jakarta/servlet/jsp/el/ExpressionEvaluator.java
index 0dfcc37..db59b26 100644
--- a/java/jakarta/servlet/jsp/el/ExpressionEvaluator.java
+++ b/java/jakarta/servlet/jsp/el/ExpressionEvaluator.java
@@ -50,7 +50,7 @@ package jakarta.servlet.jsp.el;
* <li><code>${my:reverse('hello')}</code></li>
* </ul>
*
- * @since 2.0
+ * @since JSP 2.0
* @deprecated As of JSP 2.1, replaced by jakarta.el.ExpressionFactory
*/
@Deprecated
diff --git a/java/jakarta/servlet/jsp/el/FunctionMapper.java b/java/jakarta/servlet/jsp/el/FunctionMapper.java
index 9ad8f0d..c97332a 100644
--- a/java/jakarta/servlet/jsp/el/FunctionMapper.java
+++ b/java/jakarta/servlet/jsp/el/FunctionMapper.java
@@ -22,7 +22,7 @@ package jakarta.servlet.jsp.el;
* <p>Classes implementing this interface may, for instance, consult tag library
* information to resolve the map. </p>
*
- * @since 2.0
+ * @since JSP 2.0
* @deprecated As of JSP 2.1, replaced by jakarta.el.FunctionMapper
*/
@Deprecated
diff --git a/java/jakarta/servlet/jsp/el/ImplicitObjectELResolver.java b/java/jakarta/servlet/jsp/el/ImplicitObjectELResolver.java
index 29a29c7..4ee707c 100644
--- a/java/jakarta/servlet/jsp/el/ImplicitObjectELResolver.java
+++ b/java/jakarta/servlet/jsp/el/ImplicitObjectELResolver.java
@@ -41,7 +41,7 @@ import jakarta.servlet.jsp.PageContext;
/**
* Provides resolution in EL for the implicit variables of a JSP page.
*
- * @since 2.1
+ * @since JSP 2.1
*/
public class ImplicitObjectELResolver extends ELResolver {
diff --git a/java/jakarta/servlet/jsp/el/ScopedAttributeELResolver.java b/java/jakarta/servlet/jsp/el/ScopedAttributeELResolver.java
index 4e3b145..0246f49 100644
--- a/java/jakarta/servlet/jsp/el/ScopedAttributeELResolver.java
+++ b/java/jakarta/servlet/jsp/el/ScopedAttributeELResolver.java
@@ -29,9 +29,9 @@ import jakarta.servlet.jsp.JspContext;
import jakarta.servlet.jsp.PageContext;
/**
-*
-* @since 2.1
-*/
+ *
+ * @since JSP 2.1
+ */
public class ScopedAttributeELResolver extends ELResolver {
@Override
diff --git a/java/jakarta/servlet/jsp/el/VariableResolver.java b/java/jakarta/servlet/jsp/el/VariableResolver.java
index 752a11c..7f3c3b7 100644
--- a/java/jakarta/servlet/jsp/el/VariableResolver.java
+++ b/java/jakarta/servlet/jsp/el/VariableResolver.java
@@ -29,7 +29,7 @@ package jakarta.servlet.jsp.el;
* happen
* </p>
*
- * @since 2.0
+ * @since JSP 2.0
* @deprecated As of JSP 2.1, replaced by jakarta.el.ELResolver
*/
@Deprecated
diff --git a/java/jakarta/servlet/jsp/tagext/DynamicAttributes.java b/java/jakarta/servlet/jsp/tagext/DynamicAttributes.java
index b5d7976..b5a2444 100644
--- a/java/jakarta/servlet/jsp/tagext/DynamicAttributes.java
+++ b/java/jakarta/servlet/jsp/tagext/DynamicAttributes.java
@@ -29,7 +29,7 @@ import jakarta.servlet.jsp.JspException;
* value of the attribute. It is the responsibility of the tag to
* remember the names and values of the dynamic attributes.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public interface DynamicAttributes {
diff --git a/java/jakarta/servlet/jsp/tagext/FunctionInfo.java b/java/jakarta/servlet/jsp/tagext/FunctionInfo.java
index 8945125..c2e2d20 100644
--- a/java/jakarta/servlet/jsp/tagext/FunctionInfo.java
+++ b/java/jakarta/servlet/jsp/tagext/FunctionInfo.java
@@ -21,7 +21,7 @@ package jakarta.servlet.jsp.tagext;
* This class is instantiated from the Tag Library Descriptor file (TLD)
* and is available only at translation time.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public class FunctionInfo {
diff --git a/java/jakarta/servlet/jsp/tagext/JspFragment.java b/java/jakarta/servlet/jsp/tagext/JspFragment.java
index 76b6403..ab9fb7d 100644
--- a/java/jakarta/servlet/jsp/tagext/JspFragment.java
+++ b/java/jakarta/servlet/jsp/tagext/JspFragment.java
@@ -50,7 +50,7 @@ import jakarta.servlet.jsp.JspException;
* JspFragment. Upon construction, a discriminator can be passed to
* select which fragment that instance will execute.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public abstract class JspFragment {
diff --git a/java/jakarta/servlet/jsp/tagext/JspTag.java b/java/jakarta/servlet/jsp/tagext/JspTag.java
index 6ecb05e..4224e66 100644
--- a/java/jakarta/servlet/jsp/tagext/JspTag.java
+++ b/java/jakarta/servlet/jsp/tagext/JspTag.java
@@ -20,7 +20,7 @@ package jakarta.servlet.jsp.tagext;
* Serves as a base class for Tag and SimpleTag.
* This is mostly for organizational and type-safety purposes.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public interface JspTag {
// No methods even through there are some common methods
diff --git a/java/jakarta/servlet/jsp/tagext/SimpleTag.java b/java/jakarta/servlet/jsp/tagext/SimpleTag.java
index 72ca095..aac877c 100644
--- a/java/jakarta/servlet/jsp/tagext/SimpleTag.java
+++ b/java/jakarta/servlet/jsp/tagext/SimpleTag.java
@@ -68,7 +68,7 @@ import jakarta.servlet.jsp.JspContext;
* </ol>
*
* @see SimpleTagSupport
- * @since 2.0
+ * @since JSP 2.0
*/
public interface SimpleTag extends JspTag {
diff --git a/java/jakarta/servlet/jsp/tagext/SimpleTagSupport.java b/java/jakarta/servlet/jsp/tagext/SimpleTagSupport.java
index a9b6f35..80a9144 100644
--- a/java/jakarta/servlet/jsp/tagext/SimpleTagSupport.java
+++ b/java/jakarta/servlet/jsp/tagext/SimpleTagSupport.java
@@ -30,7 +30,7 @@ import jakarta.servlet.jsp.JspException;
* convenience methods including getter methods for the properties in
* SimpleTag.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public class SimpleTagSupport implements SimpleTag {
/** Reference to the enclosing tag. */
diff --git a/java/jakarta/servlet/jsp/tagext/TagAdapter.java b/java/jakarta/servlet/jsp/tagext/TagAdapter.java
index eeaf78f..094aaa4 100644
--- a/java/jakarta/servlet/jsp/tagext/TagAdapter.java
+++ b/java/jakarta/servlet/jsp/tagext/TagAdapter.java
@@ -30,7 +30,7 @@ import jakarta.servlet.jsp.PageContext;
* setParent() instead. A classic Tag Handler can call getAdaptee() to retrieve
* the encapsulated SimpleTag instance.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public class TagAdapter implements Tag {
/** The simple tag that's being adapted. */
diff --git a/java/jakarta/servlet/jsp/tagext/TagAttributeInfo.java b/java/jakarta/servlet/jsp/tagext/TagAttributeInfo.java
index e901736..6943a26 100644
--- a/java/jakarta/servlet/jsp/tagext/TagAttributeInfo.java
+++ b/java/jakarta/servlet/jsp/tagext/TagAttributeInfo.java
@@ -68,7 +68,7 @@ public class TagAttributeInfo {
* @param fragment
* Whether this attribute is of type JspFragment
*
- * @since 2.0
+ * @since JSP 2.0
*/
public TagAttributeInfo(String name, boolean required, String type,
boolean reqTime, boolean fragment) {
@@ -181,7 +181,7 @@ public class TagAttributeInfo {
*
* @return if the attribute is of type JspFragment
*
- * @since 2.0
+ * @since JSP 2.0
*/
public boolean isFragment() {
return fragment;
diff --git a/java/jakarta/servlet/jsp/tagext/TagExtraInfo.java b/java/jakarta/servlet/jsp/tagext/TagExtraInfo.java
index e214b0d..4dec536 100644
--- a/java/jakarta/servlet/jsp/tagext/TagExtraInfo.java
+++ b/java/jakarta/servlet/jsp/tagext/TagExtraInfo.java
@@ -103,7 +103,7 @@ public abstract class TagExtraInfo {
* @param data The TagData instance.
* @return A null object, or zero length array if no errors, an
* array of ValidationMessages otherwise.
- * @since 2.0
+ * @since JSP 2.0
*/
public ValidationMessage[] validate( TagData data ) {
ValidationMessage[] result = null;
diff --git a/java/jakarta/servlet/jsp/tagext/TagFileInfo.java b/java/jakarta/servlet/jsp/tagext/TagFileInfo.java
index c024ee9..e65f159 100644
--- a/java/jakarta/servlet/jsp/tagext/TagFileInfo.java
+++ b/java/jakarta/servlet/jsp/tagext/TagFileInfo.java
@@ -21,7 +21,7 @@ package jakarta.servlet.jsp.tagext;
* This class is instantiated from the Tag Library Descriptor file (TLD)
* and is available only at translation time.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public class TagFileInfo {
diff --git a/java/jakarta/servlet/jsp/tagext/TagInfo.java b/java/jakarta/servlet/jsp/tagext/TagInfo.java
index c89f59e..a74ccb4 100644
--- a/java/jakarta/servlet/jsp/tagext/TagInfo.java
+++ b/java/jakarta/servlet/jsp/tagext/TagInfo.java
@@ -48,7 +48,7 @@ public class TagInfo {
/**
* Static constant for getBodyContent() when it is scriptless.
*
- * @since 2.0
+ * @since JSP 2.0
*/
public static final String BODY_CONTENT_SCRIPTLESS = "scriptless";
@@ -180,7 +180,7 @@ public class TagInfo {
* @param tvi An array of a TagVariableInfo (or null)
* @param dynamicAttributes True if supports dynamic attributes
*
- * @since 2.0
+ * @since JSP 2.0
*/
public TagInfo(String tagName,
String tagClassName,
@@ -275,7 +275,7 @@ public class TagInfo {
* @param data The translation-time TagData instance.
* @return A null object, or zero length array if no errors, an
* array of ValidationMessages otherwise.
- * @since 2.0
+ * @since JSP 2.0
*/
public ValidationMessage[] validate( TagData data ) {
TagExtraInfo tei = getTagExtraInfo();
@@ -426,7 +426,7 @@ public class TagInfo {
* Get dynamicAttributes associated with this TagInfo.
*
* @return True if tag handler supports dynamic attributes
- * @since 2.0
+ * @since JSP 2.0
*/
public boolean hasDynamicAttributes() {
return dynamicAttributes;
diff --git a/java/jakarta/servlet/jsp/tagext/TagLibraryInfo.java b/java/jakarta/servlet/jsp/tagext/TagLibraryInfo.java
index 393dcb5..a52760e 100644
--- a/java/jakarta/servlet/jsp/tagext/TagLibraryInfo.java
+++ b/java/jakarta/servlet/jsp/tagext/TagLibraryInfo.java
@@ -119,7 +119,7 @@ public abstract class TagLibraryInfo {
* @return the TagFileInfo objects corresponding to the tag files defined by
* this tag library, or a zero length array if this tag library
* defines no tags files
- * @since 2.0
+ * @since JSP 2.0
*/
public TagFileInfo[] getTagFiles() {
return tagFiles;
@@ -157,7 +157,7 @@ public abstract class TagLibraryInfo {
* The short name (no prefix) of the tag
* @return the TagFileInfo for the specified Tag file, or null if no Tag
* file is found
- * @since 2.0
+ * @since JSP 2.0
*/
public TagFileInfo getTagFile(String shortname) {
TagFileInfo tagFiles[] = getTagFiles();
@@ -179,7 +179,7 @@ public abstract class TagLibraryInfo {
*
* @return the functions defined in this tag library, or a zero length array
* if the tag library defines no functions.
- * @since 2.0
+ * @since JSP 2.0
*/
public FunctionInfo[] getFunctions() {
return functions;
@@ -193,7 +193,7 @@ public abstract class TagLibraryInfo {
* The name (no prefix) of the function
* @return the FunctionInfo for the function with the given name, or null if
* no such function exists
- * @since 2.0
+ * @since JSP 2.0
*/
public FunctionInfo getFunction(String name) {
@@ -221,7 +221,7 @@ public abstract class TagLibraryInfo {
* tag libraries (including this TagLibraryInfo) imported by taglib
* directives in the translation unit that references this
* TagLibraryInfo.
- * @since 2.1
+ * @since JSP 2.1
*/
public abstract jakarta.servlet.jsp.tagext.TagLibraryInfo[] getTagLibraryInfos();
@@ -246,14 +246,14 @@ public abstract class TagLibraryInfo {
/**
* An array describing the tag files that are defined in this tag library.
*
- * @since 2.0
+ * @since JSP 2.0
*/
protected TagFileInfo[] tagFiles;
/**
* An array describing the functions that are defined in this tag library.
*
- * @since 2.0
+ * @since JSP 2.0
*/
protected FunctionInfo[] functions;
diff --git a/java/jakarta/websocket/server/ServerContainer.java b/java/jakarta/websocket/server/ServerContainer.java
index 4820cb6..dbeaaea 100644
--- a/java/jakarta/websocket/server/ServerContainer.java
+++ b/java/jakarta/websocket/server/ServerContainer.java
@@ -54,6 +54,8 @@ public interface ServerContainer extends WebSocketContainer {
* Servlet container
* @throws IOException if an I/O error occurs during the establishment of a WebSocket connection
* @throws DeploymentException if a configuration error prevents the establishment of a WebSocket connection
+ *
+ * @since WebSocket 2.0
*/
public void upgradeHttpToWebSocket(Object httpServletRequest, Object httpServletResponse, ServerEndpointConfig sec,
Map<String,String> pathParameters) throws IOException, DeploymentException;
diff --git a/java/jakarta/websocket/server/ServerEndpointConfig.java b/java/jakarta/websocket/server/ServerEndpointConfig.java
index f327ed3..036c833 100644
--- a/java/jakarta/websocket/server/ServerEndpointConfig.java
+++ b/java/jakarta/websocket/server/ServerEndpointConfig.java
@@ -217,6 +217,8 @@ public interface ServerEndpointConfig extends EndpointConfig {
* Return the platform default configurator.
*
* @return the platform default configurator
+ *
+ * @since WebSocket 2.1
*/
public ServerEndpointConfig.Configurator getContainerDefaultConfigurator() {
return fetchContainerDefaultConfigurator();
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org