From 4c50eca073c0613d89e80c399d35dd90026fe371 Mon Sep 17 00:00:00 2001
From: Stephen Colebourne <scolebourne@apache.org>
Date: Sun, 8 Jun 2003 14:10:54 +0000
Subject: [PATCH] Ensure javadoc is clear about when deprecated methods will be
 removed.

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/lang/trunk@137358 13f79535-47bb-0310-9956-ffa450edef68
---
 src/java/org/apache/commons/lang/NumberRange.java | 6 ++++--
 src/java/org/apache/commons/lang/StringUtils.java | 9 ++++++++-
 src/java/org/apache/commons/lang/SystemUtils.java | 4 ++--
 3 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/src/java/org/apache/commons/lang/NumberRange.java b/src/java/org/apache/commons/lang/NumberRange.java
index 18e55ab9f..2406647e3 100644
--- a/src/java/org/apache/commons/lang/NumberRange.java
+++ b/src/java/org/apache/commons/lang/NumberRange.java
@@ -63,9 +63,11 @@ package org.apache.commons.lang;
  * @author <a href="mailto:chrise@esha.com">Christopher Elkins</a>
  * @author Stephen Colebourne
  * @since 1.0
- * @version $Revision: 1.7 $ $Date: 2003/04/09 00:07:50 $
+ * @version $Revision: 1.8 $ $Date: 2003/06/08 14:10:54 $
+ * 
+ * @deprecated Use one of the Range classes in org.apache.commons.lang.math.
+ *             Class will be removed in Commons Lang 3.0.
  * 
- * @deprecated Use one of the Range classes in org.apache.commons.lang.math
  */
 public final class NumberRange {
 
diff --git a/src/java/org/apache/commons/lang/StringUtils.java b/src/java/org/apache/commons/lang/StringUtils.java
index 7529e2fc7..956e36475 100644
--- a/src/java/org/apache/commons/lang/StringUtils.java
+++ b/src/java/org/apache/commons/lang/StringUtils.java
@@ -77,7 +77,7 @@ import java.util.StringTokenizer;
  * @author Arun Mammen Thomas
  * @author <a href="mailto:ggregory@seagullsw.com">Gary Gregory</a>
  * @since 1.0
- * @version $Id: StringUtils.java,v 1.45 2003/05/30 01:00:24 ggregory Exp $
+ * @version $Id: StringUtils.java,v 1.46 2003/06/08 14:10:54 scolebourne Exp $
  */
 public class StringUtils {
 
@@ -132,6 +132,7 @@ public class StringUtils {
      * @param str the String to check
      * @return the trimmed text (never <code>null</code>)
      * @deprecated Use the clearer named {@link #trimToEmpty(String)}.
+     *             Method will be removed in Commons Lang 3.0.
      */
     public static String clean(String str) {
         return (str == null ? "" : str.trim());
@@ -913,6 +914,7 @@ public class StringUtils {
      * @return String without chomped ending
      * @throws NullPointerException if str is <code>null</code>
      * @deprecated Use {@link #chomp(String)} instead.
+     *             Method will be removed in Commons Lang 3.0.
      */
     public static String chompLast(String str) {
         return chompLast(str, "\n");
@@ -926,6 +928,7 @@ public class StringUtils {
      * @return String without chomped ending
      * @throws NullPointerException if str or sep is <code>null</code>
      * @deprecated Use {@link #chomp(String,String)} instead.
+     *             Method will be removed in Commons Lang 3.0.
      */
     public static String chompLast(String str, String sep) {
         if (str.length() == 0) {
@@ -949,6 +952,7 @@ public class StringUtils {
      * @return String chomped
      * @throws NullPointerException if str or sep is <code>null</code>
      * @deprecated Use {@link #sliceRemainder(String,String)} instead.
+     *             Method will be removed in Commons Lang 3.0.
      */
     public static String getChomp(String str, String sep) {
         int idx = str.lastIndexOf(sep);
@@ -970,6 +974,7 @@ public class StringUtils {
      * @return String without chomped beginning
      * @throws NullPointerException if str or sep is <code>null</code>
      * @deprecated Use {@link #sliceFirstRemainder(String,String)} instead.
+     *             Method will be removed in Commons Lang 3.0.
      */
     public static String prechomp(String str, String sep) {
         int idx = str.indexOf(sep);
@@ -989,6 +994,7 @@ public class StringUtils {
      * @return String prechomped
      * @throws NullPointerException if str or sep is <code>null</code>
      * @deprecated Use {@link #sliceFirst(String,String)} instead.
+     *             Method will be removed in Commons Lang 3.0.
      */
     public static String getPrechomp(String str, String sep) {
         int idx = str.indexOf(sep);
@@ -1038,6 +1044,7 @@ public class StringUtils {
      * @return String without newline
      * @throws NullPointerException if str is <code>null</code>
      * @deprecated Use {@link #chomp(String)} instead.
+     *             Method will be removed in Commons Lang 3.0.
      */
     public static String chopNewline(String str) {
         int lastIdx = str.length() - 1;
diff --git a/src/java/org/apache/commons/lang/SystemUtils.java b/src/java/org/apache/commons/lang/SystemUtils.java
index 800132d62..4294da13e 100644
--- a/src/java/org/apache/commons/lang/SystemUtils.java
+++ b/src/java/org/apache/commons/lang/SystemUtils.java
@@ -67,7 +67,7 @@ package org.apache.commons.lang;
  * @author <a href="mailto:ggregory@seagullsw.com">Gary Gregory</a>
  * @author Michael Becke
  * @since 1.0
- * @version $Id: SystemUtils.java,v 1.15 2003/05/31 01:02:33 ggregory Exp $
+ * @version $Id: SystemUtils.java,v 1.16 2003/06/08 14:10:54 scolebourne Exp $
  */
 public class SystemUtils {
 
@@ -645,7 +645,7 @@ public class SystemUtils {
      * </ul>
      * 
      * @deprecated Use {@link #JAVA_VERSION_FLOAT} instead.
-     *             Will be removed in Commons Lang 3.0.
+     *             Method will be removed in Commons Lang 3.0.
      * @return the version, for example 1.31f for JDK 1.3.1
      */
     public static float getJavaVersion() {