Author: kkolinko
Date: Tue May 17 20:57:46 2011
New Revision: 1104557

URL: http://svn.apache.org/viewvc?rev=1104557&view=rev
Log:
Add @deprecation comments

Modified:
    tomcat/trunk/java/org/apache/catalina/core/ApplicationContextFacade.java
    tomcat/trunk/java/org/apache/catalina/core/ApplicationHttpResponse.java
    tomcat/trunk/java/org/apache/catalina/session/StandardSessionFacade.java

Modified: 
tomcat/trunk/java/org/apache/catalina/core/ApplicationContextFacade.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/core/ApplicationContextFacade.java?rev=1104557&r1=1104556&r2=1104557&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/core/ApplicationContextFacade.java 
(original)
+++ tomcat/trunk/java/org/apache/catalina/core/ApplicationContextFacade.java 
Tue May 17 20:57:46 2011
@@ -237,7 +237,7 @@ public class ApplicationContextFacade im
 
 
     /**
-     * @deprecated
+     * @deprecated As of Java Servlet API 2.1, with no direct replacement.
      */
     @Override
     @Deprecated
@@ -261,7 +261,7 @@ public class ApplicationContextFacade im
 
 
     /**
-     * @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 im
 
 
     /**
-     * @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 im
 
 
     /**
-     * @deprecated
+     * @deprecated As of Java Servlet API 2.1, use
+     *  <code>log(String, Throwable)</code> instead
      */
     @Override
     @Deprecated

Modified: 
tomcat/trunk/java/org/apache/catalina/core/ApplicationHttpResponse.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/core/ApplicationHttpResponse.java?rev=1104557&r1=1104556&r2=1104557&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/core/ApplicationHttpResponse.java 
(original)
+++ tomcat/trunk/java/org/apache/catalina/core/ApplicationHttpResponse.java Tue 
May 17 20:57:46 2011
@@ -339,7 +339,10 @@ class ApplicationHttpResponse extends Ht
      *
      * @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

Modified: 
tomcat/trunk/java/org/apache/catalina/session/StandardSessionFacade.java
URL: 
http://svn.apache.org/viewvc/tomcat/trunk/java/org/apache/catalina/session/StandardSessionFacade.java?rev=1104557&r1=1104556&r2=1104557&view=diff
==============================================================================
--- tomcat/trunk/java/org/apache/catalina/session/StandardSessionFacade.java 
(original)
+++ tomcat/trunk/java/org/apache/catalina/session/StandardSessionFacade.java 
Tue May 17 20:57:46 2011
@@ -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



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org

Reply via email to