Add @deprecation comments

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1104557 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/java/org/apache/catalina/core/ApplicationContextFacade.java b/java/org/apache/catalina/core/ApplicationContextFacade.java
index e1bb07d..3da130f 100644 (file)
--- a/java/org/apache/catalina/core/ApplicationContextFacade.java
+++ b/java/org/apache/catalina/core/ApplicationContextFacade.java
@@ -237,7 +237,7 @@ public class ApplicationContextFacade implements ServletContext {
 
 
     /**
-     * @deprecated
+     * @deprecated As of Java Servlet API 2.1, with no direct replacement.
      */
     @Override
     @Deprecated
@@ -261,7 +261,7 @@ public class ApplicationContextFacade implements ServletContext {
 
 
     /**
-     * @deprecated
+     * @deprecated As of Java Servlet API 2.1, with no direct replacement.
      */
     @Override
     @SuppressWarnings("unchecked") // doPrivileged() returns the correct type
@@ -276,7 +276,7 @@ public class ApplicationContextFacade implements ServletContext {
 
 
     /**
-     * @deprecated
+     * @deprecated As of Java Servlet API 2.1, with no direct replacement.
      */
     @Override
     @SuppressWarnings("unchecked") // doPrivileged() returns the correct type
@@ -301,7 +301,8 @@ public class ApplicationContextFacade implements ServletContext {
 
 
     /**
-     * @deprecated
+     * @deprecated As of Java Servlet API 2.1, use
+     *  <code>log(String, Throwable)</code> instead
      */
     @Override
     @Deprecated

diff --git a/java/org/apache/catalina/core/ApplicationHttpResponse.java b/java/org/apache/catalina/core/ApplicationHttpResponse.java
index 690bd0d..44826dc 100644 (file)
--- a/java/org/apache/catalina/core/ApplicationHttpResponse.java
+++ b/java/org/apache/catalina/core/ApplicationHttpResponse.java
@@ -339,7 +339,10 @@ class ApplicationHttpResponse extends HttpServletResponseWrapper {
      *
      * @param sc The new status code
      * @param msg The new message
-     * @deprecated
+     * @deprecated As of version 2.1, due to ambiguous meaning of the message
+     *             parameter. To set a status code use
+     *             <code>setStatus(int)</code>, to send an error with a
+     *             description use <code>sendError(int, String)</code>.
      */
     @Deprecated
     @Override

diff --git a/java/org/apache/catalina/session/StandardSessionFacade.java b/java/org/apache/catalina/session/StandardSessionFacade.java
index 7faec12..5bb83eb 100644 (file)
--- a/java/org/apache/catalina/session/StandardSessionFacade.java
+++ b/java/org/apache/catalina/session/StandardSessionFacade.java
@@ -108,7 +108,8 @@ public class StandardSessionFacade
 
 
     /**
-     * @deprecated
+     * @deprecated As of Version 2.1, this method is deprecated and has no
+     *             replacement.
      */
     @Override
     @Deprecated
@@ -124,7 +125,8 @@ public class StandardSessionFacade
 
 
     /**
-     * @deprecated
+     * @deprecated As of Version 2.2, this method is replaced by
+     *             {@link #getAttribute}.
      */
     @Override
     @Deprecated
@@ -140,7 +142,8 @@ public class StandardSessionFacade
 
 
     /**
-     * @deprecated
+     * @deprecated As of Version 2.2, this method is replaced by
+     *             {@link #getAttributeNames}
      */
     @Override
     @Deprecated
@@ -156,7 +159,8 @@ public class StandardSessionFacade
 
 
     /**
-     * @deprecated
+     * @deprecated As of Version 2.2, this method is replaced by
+     *             {@link #setAttribute}
      */
     @Override
     @Deprecated
@@ -172,7 +176,8 @@ public class StandardSessionFacade
 
 
     /**
-     * @deprecated
+     * @deprecated As of Version 2.2, this method is replaced by
+     *             {@link #removeAttribute}
      */
     @Override
     @Deprecated