From c261fa490e68cf5b38930ff66ce17216d9e45c97 Mon Sep 17 00:00:00 2001
From: Stephen Colebourne <scolebourne@apache.org>
Date: Wed, 24 Dec 2003 01:33:30 +0000
Subject: [PATCH] Fix mistake and clarify javadoc spec for replace

git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/lang/trunk@137730 13f79535-47bb-0310-9956-ffa450edef68
---
 .../org/apache/commons/lang/StringUtils.java  | 24 +++++++++++--------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/src/java/org/apache/commons/lang/StringUtils.java b/src/java/org/apache/commons/lang/StringUtils.java
index e3f617a3f..0fab4bb2f 100644
--- a/src/java/org/apache/commons/lang/StringUtils.java
+++ b/src/java/org/apache/commons/lang/StringUtils.java
@@ -148,7 +148,7 @@
  * @author Phil Steitz
  * @author Al Chou
  * @since 1.0
- * @version $Id: StringUtils.java,v 1.121 2003/12/15 01:51:36 ggregory Exp $
+ * @version $Id: StringUtils.java,v 1.122 2003/12/24 01:33:30 scolebourne Exp $
  */
 public class StringUtils {
     // Performance testing notes (JDK 1.4, Jul03, scolebourne)
@@ -2544,10 +2544,11 @@ public static String removeEnd(String str, String remove) {
      * <pre>
      * StringUtils.replaceOnce(null, *, *)        = null
      * StringUtils.replaceOnce("", *, *)          = ""
-     * StringUtils.replaceOnce("aba", null, null) = "aba"
-     * StringUtils.replaceOnce("aba", null, null) = "aba"
+     * StringUtils.replaceOnce("any", null, *)    = "any"
+     * StringUtils.replaceOnce("any", *, null)    = "any"
+     * StringUtils.replaceOnce("any", "", *)      = "any"
      * StringUtils.replaceOnce("aba", "a", null)  = "aba"
-     * StringUtils.replaceOnce("aba", "a", "")    = "aba"
+     * StringUtils.replaceOnce("aba", "a", "")    = "ba"
      * StringUtils.replaceOnce("aba", "a", "z")   = "zba"
      * </pre>
      *
@@ -2570,8 +2571,9 @@ public static String replaceOnce(String text, String repl, String with) {
      * <pre>
      * StringUtils.replace(null, *, *)        = null
      * StringUtils.replace("", *, *)          = ""
-     * StringUtils.replace("aba", null, null) = "aba"
-     * StringUtils.replace("aba", null, null) = "aba"
+     * StringUtils.replace("any", null, *)    = "any"
+     * StringUtils.replace("any", *, null)    = "any"
+     * StringUtils.replace("any", "", *)      = "any"
      * StringUtils.replace("aba", "a", null)  = "aba"
      * StringUtils.replace("aba", "a", "")    = "b"
      * StringUtils.replace("aba", "a", "z")   = "zbz"
@@ -2597,10 +2599,12 @@ public static String replace(String text, String repl, String with) {
      * <pre>
      * StringUtils.replace(null, *, *, *)         = null
      * StringUtils.replace("", *, *, *)           = ""
-     * StringUtils.replace("abaa", null, null, 1) = "abaa"
-     * StringUtils.replace("abaa", null, null, 1) = "abaa"
-     * StringUtils.replace("abaa", "a", null, 1)  = "abaa"
-     * StringUtils.replace("abaa", "a", "", 1)    = "abaa"
+     * StringUtils.replace("any", null, *, *)     = "any"
+     * StringUtils.replace("any", *, null, *)     = "any"
+     * StringUtils.replace("any", "", *, *)       = "any"
+     * StringUtils.replace("any", *, *, 0)        = "any"
+     * StringUtils.replace("abaa", "a", null, -1) = "abaa"
+     * StringUtils.replace("abaa", "a", "", -1)   = "b"
      * StringUtils.replace("abaa", "a", "z", 0)   = "abaa"
      * StringUtils.replace("abaa", "a", "z", 1)   = "zbaa"
      * StringUtils.replace("abaa", "a", "z", 2)   = "zbza"