This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch 9.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/9.0.x by this push:
new 4d9e96a Javadoc clean-up including missing @since tags
4d9e96a is described below
commit 4d9e96a3f4addf04d1a858be719e5716fccff7a2
Author: Mark Thomas <[email protected]>
AuthorDate: Fri Nov 19 12:27:44 2021 +0000
Javadoc clean-up including missing @since tags
---
java/javax/servlet/FilterChain.java | 3 +--
java/javax/servlet/FilterConfig.java | 1 -
java/javax/servlet/GenericFilter.java | 2 ++
java/javax/servlet/RequestDispatcher.java | 1 -
java/javax/servlet/ServletContext.java | 1 +
java/javax/servlet/ServletContextAttributeEvent.java | 1 +
java/javax/servlet/ServletContextAttributeListener.java | 3 ++-
java/javax/servlet/ServletContextEvent.java | 1 +
java/javax/servlet/ServletContextListener.java | 2 +-
java/javax/servlet/ServletRequest.java | 2 ++
java/javax/servlet/ServletRequestWrapper.java | 4 +++-
java/javax/servlet/ServletResponse.java | 1 +
java/javax/servlet/http/HttpServletRequestWrapper.java | 2 ++
java/javax/servlet/http/HttpServletResponse.java | 2 +-
java/javax/servlet/http/HttpUpgradeHandler.java | 2 --
15 files changed, 18 insertions(+), 10 deletions(-)
diff --git a/java/javax/servlet/FilterChain.java
b/java/javax/servlet/FilterChain.java
index 09fe64d..06c67b8 100644
--- a/java/javax/servlet/FilterChain.java
+++ b/java/javax/servlet/FilterChain.java
@@ -27,8 +27,7 @@ import java.io.IOException;
*
* @see Filter
* @since Servlet 2.3
- **/
-
+ */
public interface FilterChain {
/**
diff --git a/java/javax/servlet/FilterConfig.java
b/java/javax/servlet/FilterConfig.java
index 3af26ec..3988a27 100644
--- a/java/javax/servlet/FilterConfig.java
+++ b/java/javax/servlet/FilterConfig.java
@@ -19,7 +19,6 @@ package javax.servlet;
import java.util.Enumeration;
/**
- *
* A filter configuration object used by a servlet container to pass
information
* to a filter during initialization.
*
diff --git a/java/javax/servlet/GenericFilter.java
b/java/javax/servlet/GenericFilter.java
index a6232a8..bdcac0c 100644
--- a/java/javax/servlet/GenericFilter.java
+++ b/java/javax/servlet/GenericFilter.java
@@ -25,6 +25,8 @@ import java.util.Enumeration;
*
* @see javax.servlet.Filter
* @see javax.servlet.FilterConfig
+ *
+ * @since Servlet 4.0
*/
public abstract class GenericFilter implements Filter, FilterConfig,
Serializable {
diff --git a/java/javax/servlet/RequestDispatcher.java
b/java/javax/servlet/RequestDispatcher.java
index 73bfe7e..7eaa63a 100644
--- a/java/javax/servlet/RequestDispatcher.java
+++ b/java/javax/servlet/RequestDispatcher.java
@@ -32,7 +32,6 @@ import java.io.IOException;
* @see ServletContext#getRequestDispatcher(java.lang.String)
* @see ServletContext#getNamedDispatcher(java.lang.String)
* @see ServletRequest#getRequestDispatcher(java.lang.String)
- *
*/
public interface RequestDispatcher {
diff --git a/java/javax/servlet/ServletContext.java
b/java/javax/servlet/ServletContext.java
index 43b39e2..68a3aab 100644
--- a/java/javax/servlet/ServletContext.java
+++ b/java/javax/servlet/ServletContext.java
@@ -519,6 +519,7 @@ public interface ServletContext {
* method with an attribute name to get the value of an attribute.
*
* @return an <code>Enumeration</code> of attribute names
+ *
* @see #getAttribute
*/
public Enumeration<String> getAttributeNames();
diff --git a/java/javax/servlet/ServletContextAttributeEvent.java
b/java/javax/servlet/ServletContextAttributeEvent.java
index 888aaf2..cb2cd78 100644
--- a/java/javax/servlet/ServletContextAttributeEvent.java
+++ b/java/javax/servlet/ServletContextAttributeEvent.java
@@ -21,6 +21,7 @@ package javax.servlet;
* the servlet context of a web application.
*
* @see ServletContextAttributeListener
+ *
* @since Servlet 2.3
*/
public class ServletContextAttributeEvent extends ServletContextEvent {
diff --git a/java/javax/servlet/ServletContextAttributeListener.java
b/java/javax/servlet/ServletContextAttributeListener.java
index 1dec202..6a87d8e 100644
--- a/java/javax/servlet/ServletContextAttributeListener.java
+++ b/java/javax/servlet/ServletContextAttributeListener.java
@@ -25,10 +25,11 @@ import java.util.EventListener;
* deployment descriptor for the web application.
*
* @see ServletContextAttributeEvent
+ *
* @since Servlet 2.3
*/
-
public interface ServletContextAttributeListener extends EventListener {
+
/**
* Notification that a new attribute was added to the servlet context.
* Called after the attribute is added.
diff --git a/java/javax/servlet/ServletContextEvent.java
b/java/javax/servlet/ServletContextEvent.java
index fc16312..ac0a53c 100644
--- a/java/javax/servlet/ServletContextEvent.java
+++ b/java/javax/servlet/ServletContextEvent.java
@@ -21,6 +21,7 @@ package javax.servlet;
* context of a web application.
*
* @see ServletContextListener
+ *
* @since Servlet 2.3
*/
public class ServletContextEvent extends java.util.EventObject {
diff --git a/java/javax/servlet/ServletContextListener.java
b/java/javax/servlet/ServletContextListener.java
index 5569c7a..851cfaf 100644
--- a/java/javax/servlet/ServletContextListener.java
+++ b/java/javax/servlet/ServletContextListener.java
@@ -25,9 +25,9 @@ import java.util.EventListener;
* deployment descriptor for the web application.
*
* @see ServletContextEvent
+ *
* @since Servlet 2.3
*/
-
public interface ServletContextListener extends EventListener {
/**
diff --git a/java/javax/servlet/ServletRequest.java
b/java/javax/servlet/ServletRequest.java
index 68e00d3..9e61dd6 100644
--- a/java/javax/servlet/ServletRequest.java
+++ b/java/javax/servlet/ServletRequest.java
@@ -417,6 +417,7 @@ public interface ServletRequest {
* proxy that sent the request.
*
* @return an integer specifying the port number
+ *
* @since Servlet 2.4
*/
public int getRemotePort();
@@ -446,6 +447,7 @@ public interface ServletRequest {
* the request was received.
*
* @return an integer specifying the port number
+ *
* @since Servlet 2.4
*/
public int getLocalPort();
diff --git a/java/javax/servlet/ServletRequestWrapper.java
b/java/javax/servlet/ServletRequestWrapper.java
index 53029fa..c30a551 100644
--- a/java/javax/servlet/ServletRequestWrapper.java
+++ b/java/javax/servlet/ServletRequestWrapper.java
@@ -29,8 +29,9 @@ import java.util.ResourceBundle;
* class implements the Wrapper or Decorator pattern. Methods default to
calling
* through to the wrapped request object.
*
- * @since Servlet 2.3
* @see javax.servlet.ServletRequest
+ *
+ * @since Servlet 2.3
*/
public class ServletRequestWrapper implements ServletRequest {
private static final String LSTRING_FILE = "javax.servlet.LocalStrings";
@@ -63,6 +64,7 @@ public class ServletRequestWrapper implements ServletRequest {
/**
* Sets the request object being wrapped.
+ *
* @param request The new wrapped request.
*
* @throws IllegalArgumentException if the request is null.
diff --git a/java/javax/servlet/ServletResponse.java
b/java/javax/servlet/ServletResponse.java
index 6427c51..70e1f72 100644
--- a/java/javax/servlet/ServletResponse.java
+++ b/java/javax/servlet/ServletResponse.java
@@ -288,6 +288,7 @@ public interface ServletResponse {
* @see #getBufferSize
* @see #isCommitted
* @see #reset
+ *
* @since Servlet 2.3
*/
public void resetBuffer();
diff --git a/java/javax/servlet/http/HttpServletRequestWrapper.java
b/java/javax/servlet/http/HttpServletRequestWrapper.java
index 5c446b8..ee52dbe 100644
--- a/java/javax/servlet/http/HttpServletRequestWrapper.java
+++ b/java/javax/servlet/http/HttpServletRequestWrapper.java
@@ -256,6 +256,8 @@ public class HttpServletRequestWrapper extends
ServletRequestWrapper implements
/**
* The default behavior of this method is to call changeSessionId() on the
* wrapped request object.
+ *
+ * @since Servlet 3.1
*/
@Override
public String changeSessionId() {
diff --git a/java/javax/servlet/http/HttpServletResponse.java
b/java/javax/servlet/http/HttpServletResponse.java
index a108654..ad6e607 100644
--- a/java/javax/servlet/http/HttpServletResponse.java
+++ b/java/javax/servlet/http/HttpServletResponse.java
@@ -377,7 +377,7 @@ public interface HttpServletResponse extends
ServletResponse {
}
/*
- * Server status codes; see RFC 2068.
+ * Server status codes; see RFC 7231.
*/
/**
diff --git a/java/javax/servlet/http/HttpUpgradeHandler.java
b/java/javax/servlet/http/HttpUpgradeHandler.java
index 095200c..be8a60c 100644
--- a/java/javax/servlet/http/HttpUpgradeHandler.java
+++ b/java/javax/servlet/http/HttpUpgradeHandler.java
@@ -30,8 +30,6 @@ public interface HttpUpgradeHandler {
* the container to the {@link HttpUpgradeHandler}.
*
* @param connection The connection that has been upgraded
- *
- * @since Servlet 3.1
*/
void init(WebConnection connection);
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
