This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch 10.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git
The following commit(s) were added to refs/heads/10.0.x by this push:
new 4052116 Javadoc clean-up including missing @since tags
4052116 is described below
commit 4052116e42aa744e7c1aef744fae00effe1706f2
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Fri Nov 19 12:27:44 2021 +0000
Javadoc clean-up including missing @since tags
---
java/jakarta/servlet/FilterChain.java | 3 +--
java/jakarta/servlet/FilterConfig.java | 1 -
java/jakarta/servlet/GenericFilter.java | 2 ++
java/jakarta/servlet/RequestDispatcher.java | 1 -
java/jakarta/servlet/ServletContext.java | 1 +
java/jakarta/servlet/ServletContextAttributeEvent.java | 1 +
java/jakarta/servlet/ServletContextAttributeListener.java | 3 ++-
java/jakarta/servlet/ServletContextEvent.java | 1 +
java/jakarta/servlet/ServletContextListener.java | 2 +-
java/jakarta/servlet/ServletRequest.java | 2 ++
java/jakarta/servlet/ServletRequestWrapper.java | 4 +++-
java/jakarta/servlet/ServletResponse.java | 1 +
java/jakarta/servlet/http/HttpServletRequestWrapper.java | 2 ++
java/jakarta/servlet/http/HttpServletResponse.java | 2 +-
java/jakarta/servlet/http/HttpUpgradeHandler.java | 2 --
15 files changed, 18 insertions(+), 10 deletions(-)
diff --git a/java/jakarta/servlet/FilterChain.java
b/java/jakarta/servlet/FilterChain.java
index 535853f..67ef198 100644
--- a/java/jakarta/servlet/FilterChain.java
+++ b/java/jakarta/servlet/FilterChain.java
@@ -27,8 +27,7 @@ import java.io.IOException;
*
* @see Filter
* @since Servlet 2.3
- **/
-
+ */
public interface FilterChain {
/**
diff --git a/java/jakarta/servlet/FilterConfig.java
b/java/jakarta/servlet/FilterConfig.java
index e9fc00b..a787565 100644
--- a/java/jakarta/servlet/FilterConfig.java
+++ b/java/jakarta/servlet/FilterConfig.java
@@ -19,7 +19,6 @@ package jakarta.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/jakarta/servlet/GenericFilter.java
b/java/jakarta/servlet/GenericFilter.java
index 3cdb815..a69ac3f 100644
--- a/java/jakarta/servlet/GenericFilter.java
+++ b/java/jakarta/servlet/GenericFilter.java
@@ -25,6 +25,8 @@ import java.util.Enumeration;
*
* @see jakarta.servlet.Filter
* @see jakarta.servlet.FilterConfig
+ *
+ * @since Servlet 4.0
*/
public abstract class GenericFilter implements Filter, FilterConfig,
Serializable {
diff --git a/java/jakarta/servlet/RequestDispatcher.java
b/java/jakarta/servlet/RequestDispatcher.java
index 11c498e..0c94b00 100644
--- a/java/jakarta/servlet/RequestDispatcher.java
+++ b/java/jakarta/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/jakarta/servlet/ServletContext.java
b/java/jakarta/servlet/ServletContext.java
index ce18fa6..51d9064 100644
--- a/java/jakarta/servlet/ServletContext.java
+++ b/java/jakarta/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/jakarta/servlet/ServletContextAttributeEvent.java
b/java/jakarta/servlet/ServletContextAttributeEvent.java
index 0149da5..0a21406 100644
--- a/java/jakarta/servlet/ServletContextAttributeEvent.java
+++ b/java/jakarta/servlet/ServletContextAttributeEvent.java
@@ -21,6 +21,7 @@ package jakarta.servlet;
* the servlet context of a web application.
*
* @see ServletContextAttributeListener
+ *
* @since Servlet 2.3
*/
public class ServletContextAttributeEvent extends ServletContextEvent {
diff --git a/java/jakarta/servlet/ServletContextAttributeListener.java
b/java/jakarta/servlet/ServletContextAttributeListener.java
index 25e42ba..ded0ca8 100644
--- a/java/jakarta/servlet/ServletContextAttributeListener.java
+++ b/java/jakarta/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/jakarta/servlet/ServletContextEvent.java
b/java/jakarta/servlet/ServletContextEvent.java
index 7cf5408..8143088 100644
--- a/java/jakarta/servlet/ServletContextEvent.java
+++ b/java/jakarta/servlet/ServletContextEvent.java
@@ -21,6 +21,7 @@ package jakarta.servlet;
* context of a web application.
*
* @see ServletContextListener
+ *
* @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 c5e33d4..88327ef 100644
--- a/java/jakarta/servlet/ServletContextListener.java
+++ b/java/jakarta/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/jakarta/servlet/ServletRequest.java
b/java/jakarta/servlet/ServletRequest.java
index 1d0bbdd..a864c8a 100644
--- a/java/jakarta/servlet/ServletRequest.java
+++ b/java/jakarta/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/jakarta/servlet/ServletRequestWrapper.java
b/java/jakarta/servlet/ServletRequestWrapper.java
index 67ec408..f49cf48 100644
--- a/java/jakarta/servlet/ServletRequestWrapper.java
+++ b/java/jakarta/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 jakarta.servlet.ServletRequest
+ *
+ * @since Servlet 2.3
*/
public class ServletRequestWrapper implements ServletRequest {
private static final String LSTRING_FILE = "jakarta.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/jakarta/servlet/ServletResponse.java
b/java/jakarta/servlet/ServletResponse.java
index ad19476..5950515 100644
--- a/java/jakarta/servlet/ServletResponse.java
+++ b/java/jakarta/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/jakarta/servlet/http/HttpServletRequestWrapper.java
b/java/jakarta/servlet/http/HttpServletRequestWrapper.java
index 1b7f4a1..393a257 100644
--- a/java/jakarta/servlet/http/HttpServletRequestWrapper.java
+++ b/java/jakarta/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/jakarta/servlet/http/HttpServletResponse.java
b/java/jakarta/servlet/http/HttpServletResponse.java
index 4fb5538..d5e5456 100644
--- a/java/jakarta/servlet/http/HttpServletResponse.java
+++ b/java/jakarta/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/jakarta/servlet/http/HttpUpgradeHandler.java
b/java/jakarta/servlet/http/HttpUpgradeHandler.java
index b1b152b..a2479be 100644
--- a/java/jakarta/servlet/http/HttpUpgradeHandler.java
+++ b/java/jakarta/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: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
