From: kkolinko <kkolinko@13f79535-47bb-0310-9956-ffa450edef68>
Date: Tue, 17 May 2011 20:57:46 +0000 (+0000)
Subject: Add @deprecation comments
X-Git-Url: https://git.internetallee.de/?a=commitdiff_plain;h=8053e8724feeda779130d41fdf917ac81681892f;p=tomcat7.0

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 e1bb07db6..3da130f3a 100644
--- 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 690bd0dcd..44826dc0d 100644
--- 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 7faec12e7..5bb83ebc8 100644
--- 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