Javadoc

apache · Feb 5, 2025 · 9923a60 · 9923a60
1 parent 1286cc2
commit 9923a60
Show file tree

Hide file tree

Showing 24 changed files with 51 additions and 51 deletions.
diff --git a/src/main/java/org/apache/commons/lang3/text/CompositeFormat.java b/src/main/java/org/apache/commons/lang3/text/CompositeFormat.java
@@ -25,9 +25,9 @@
  * Formats using one formatter and parses using a different formatter. An
  * example of use for this would be a webapp where data is taken in one way and
  * stored in a database another way.
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/CompositeFormat.html">
- * CompositeFormat</a> instead
+ * CompositeFormat</a>.
  */
 @Deprecated
 public class CompositeFormat extends Format {

diff --git a/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java b/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
@@ -65,9 +65,9 @@
  * </ul>
  *
  * @since 2.4
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/ExtendedMessageFormat.html">
- * ExtendedMessageFormat</a> instead
+ * ExtendedMessageFormat</a>.
  */
 @Deprecated
 public class ExtendedMessageFormat extends MessageFormat {

diff --git a/src/main/java/org/apache/commons/lang3/text/FormatFactory.java b/src/main/java/org/apache/commons/lang3/text/FormatFactory.java
@@ -23,9 +23,9 @@
  * Format factory.
  *
  * @since 2.4
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/FormatFactory.html">
- * FormatFactory</a> instead
+ * FormatFactory</a>.
  */
 @Deprecated
 public interface FormatFactory {

diff --git a/src/main/java/org/apache/commons/lang3/text/FormattableUtils.java b/src/main/java/org/apache/commons/lang3/text/FormattableUtils.java
@@ -32,9 +32,9 @@
  * and padding, and is not designed to allow generalized alternate formats.</p>
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/FormattableUtils.html">
- * FormattableUtils</a> instead
+ * FormattableUtils</a>.
  */
 @Deprecated
 public class FormattableUtils {

diff --git a/src/main/java/org/apache/commons/lang3/text/StrBuilder.java b/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
@@ -78,9 +78,9 @@
  * </p>
  *
  * @since 2.2
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/TextStringBuilder.html">
- * TextStringBuilder</a> instead
+ * TextStringBuilder</a>.
  */
 @Deprecated
 public class StrBuilder implements CharSequence, Appendable, Serializable, Builder<String> {

diff --git a/src/main/java/org/apache/commons/lang3/text/StrLookup.java b/src/main/java/org/apache/commons/lang3/text/StrLookup.java
@@ -39,9 +39,9 @@
  *
  * @param <V> Unused.
  * @since 2.2
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/lookup/StringLookupFactory.html">
- * StringLookupFactory</a> instead
+ * StringLookupFactory</a>.
  */
 @Deprecated
 public abstract class StrLookup<V> {

diff --git a/src/main/java/org/apache/commons/lang3/text/StrMatcher.java b/src/main/java/org/apache/commons/lang3/text/StrMatcher.java
@@ -31,9 +31,9 @@
  * </p>
  *
  * @since 2.2
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/matcher/StringMatcherFactory.html">
- * StringMatcherFactory</a> instead
+ * StringMatcherFactory</a>.
  */
 @Deprecated
 public abstract class StrMatcher {

diff --git a/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java b/src/main/java/org/apache/commons/lang3/text/StrSubstitutor.java
@@ -141,9 +141,9 @@
  * </p>
  *
  * @since 2.2
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/StringSubstitutor.html">
- * StringSubstitutor</a> instead
+ * StringSubstitutor</a>.
  */
 @Deprecated
 public class StrSubstitutor {

diff --git a/src/main/java/org/apache/commons/lang3/text/StrTokenizer.java b/src/main/java/org/apache/commons/lang3/text/StrTokenizer.java
@@ -89,9 +89,9 @@
  * </table>
  *
  * @since 2.2
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/StringTokenizer.html">
- * StringTokenizer</a> instead
+ * StringTokenizer</a>.
  */
 @Deprecated
 public class StrTokenizer implements ListIterator<String>, Cloneable {

diff --git a/src/main/java/org/apache/commons/lang3/text/WordUtils.java b/src/main/java/org/apache/commons/lang3/text/WordUtils.java
@@ -30,9 +30,9 @@
  * Each method documents its behavior in more detail.</p>
  *
  * @since 2.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/WordUtils.html">
- * WordUtils</a> instead
+ * WordUtils</a>.
  */
 @Deprecated
 public class WordUtils {

diff --git a/src/main/java/org/apache/commons/lang3/text/package-info.java b/src/main/java/org/apache/commons/lang3/text/package-info.java
@@ -16,7 +16,7 @@
  */
 
 /**
- * Provides classes for handling and manipulating text, partly as an extension to {@link java.text}. The classes in this package are, for the most part,
+ * Deprecated: Provides classes for handling and manipulating text, partly as an extension to {@link java.text}. The classes in this package are, for the most part,
  * intended to be instantiated (i.e. they are not utility classes with lots of static methods).
  *
  * <p>
@@ -26,7 +26,7 @@
  * ensure we don't clash with any current or future standard Java classes.
  * </p>
  * <p>
- * <strong>Deprecated</strong> As of 3.6, use the Apache Commons Text
+ * <strong>Deprecated</strong> As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use the Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/package-summary.html"> text package</a>.
  * </p>
  *

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/AggregateTranslator.java b/src/main/java/org/apache/commons/lang3/text/translate/AggregateTranslator.java
@@ -26,9 +26,9 @@
  * the first translator consumes code points from the input.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/AggregateTranslator.html">
- * AggregateTranslator</a> instead
+ * AggregateTranslator</a>.
  */
 @Deprecated
 public class AggregateTranslator extends CharSequenceTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/CharSequenceTranslator.java b/src/main/java/org/apache/commons/lang3/text/translate/CharSequenceTranslator.java
@@ -31,9 +31,9 @@
  * is completely contextual, the API does not present two separate signatures.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/CharSequenceTranslator.html">
- * CharSequenceTranslator</a> instead
+ * CharSequenceTranslator</a>.
  */
 @Deprecated
 public abstract class CharSequenceTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/CodePointTranslator.java b/src/main/java/org/apache/commons/lang3/text/translate/CodePointTranslator.java
@@ -24,9 +24,9 @@
  * will replace up to one character at a time.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/CodePointTranslator.html">
- * CharSequenceTranslator</a> instead
+ * CharSequenceTranslator</a>.
  */
 @Deprecated
 public abstract class CodePointTranslator extends CharSequenceTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/EntityArrays.java b/src/main/java/org/apache/commons/lang3/text/translate/EntityArrays.java
@@ -22,9 +22,9 @@
  * All arrays are of length [*][2].
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/CodePointTranslator.html">
- * EntityArrays</a> instead
+ * EntityArrays</a>.
  */
 @Deprecated
 public class EntityArrays {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/JavaUnicodeEscaper.java b/src/main/java/org/apache/commons/lang3/text/translate/JavaUnicodeEscaper.java
@@ -20,9 +20,9 @@
  * Translates code points to their Unicode escaped value suitable for Java source.
  *
  * @since 3.2
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/UnicodeEscaper.html">
- * UnicodeEscaper</a> instead
+ * UnicodeEscaper</a>.
  */
 @Deprecated
 public class JavaUnicodeEscaper extends UnicodeEscaper {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/LookupTranslator.java b/src/main/java/org/apache/commons/lang3/text/translate/LookupTranslator.java
@@ -25,9 +25,9 @@
  * Translates a value using a lookup table.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/LookupTranslator.html">
- * LookupTranslator</a> instead
+ * LookupTranslator</a>.
  */
 @Deprecated
 public class LookupTranslator extends CharSequenceTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityEscaper.java b/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityEscaper.java
@@ -23,9 +23,9 @@
  * Translates code points to their XML numeric entity escaped value.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/NumericEntityEscaper.html">
- * NumericEntityEscaper</a> instead
+ * NumericEntityEscaper</a>.
  */
 @Deprecated
 public class NumericEntityEscaper extends CodePointTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityUnescaper.java b/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityUnescaper.java
@@ -23,15 +23,14 @@
 import java.util.EnumSet;
 
 /**
- * Translate XML numeric entities of the form &amp;#[xX]?\d+;? to
- * the specific code point.
+ * Translate XML numeric entities of the form &amp;#[xX]?\d+;? to the specific code point.
  *
  * Note that the semicolon is optional.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
- * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/NumericEntityUnescaper.html">
- * NumericEntityUnescaper</a> instead
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
+ *             <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/NumericEntityUnescaper.html">
+ *             NumericEntityUnescaper</a>.
  */
 @Deprecated
 public class NumericEntityUnescaper extends CharSequenceTranslator {
@@ -41,6 +40,7 @@ public class NumericEntityUnescaper extends CharSequenceTranslator {
      *
      * @deprecated As of 3.18.0, use Apache Commons Text <a href=
      *             "https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/NumericEntityUnescaper.OPTION.html">
+     *             NumericEntityUnescaper.OPTION</a>.
      */
     @Deprecated
     public enum OPTION {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/OctalUnescaper.java b/src/main/java/org/apache/commons/lang3/text/translate/OctalUnescaper.java
@@ -28,9 +28,9 @@
  * 1 to 377. This is because parsing Java is the main use case.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/OctalUnescaper.html">
- * OctalUnescaper</a> instead
+ * OctalUnescaper</a>.
  */
 @Deprecated
 public class OctalUnescaper extends CharSequenceTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/UnicodeEscaper.java b/src/main/java/org/apache/commons/lang3/text/translate/UnicodeEscaper.java
@@ -23,9 +23,9 @@
  * Translates code points to their Unicode escaped value.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/UnicodeEscaper.html">
- * UnicodeEscaper</a> instead
+ * UnicodeEscaper</a>.
  */
 @Deprecated
 public class UnicodeEscaper extends CodePointTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/UnicodeUnescaper.java b/src/main/java/org/apache/commons/lang3/text/translate/UnicodeUnescaper.java
@@ -25,9 +25,9 @@
  * without the +.
  *
  * @since 3.0
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/UnicodeUnescaper.html">
- * UnicodeUnescaper</a> instead
+ * UnicodeUnescaper</a>.
  */
 @Deprecated
 public class UnicodeUnescaper extends CharSequenceTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/UnicodeUnpairedSurrogateRemover.java b/src/main/java/org/apache/commons/lang3/text/translate/UnicodeUnpairedSurrogateRemover.java
@@ -22,9 +22,9 @@
 /**
  * Helper subclass to CharSequenceTranslator to remove unpaired surrogates.
  *
- * @deprecated As of 3.6, use Apache Commons Text
+ * @deprecated As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/UnicodeUnpairedSurrogateRemover.html">
- * UnicodeUnpairedSurrogateRemover</a> instead
+ * UnicodeUnpairedSurrogateRemover</a>.
  */
 @Deprecated
 public class UnicodeUnpairedSurrogateRemover extends CodePointTranslator {

diff --git a/src/main/java/org/apache/commons/lang3/text/translate/package-info.java b/src/main/java/org/apache/commons/lang3/text/translate/package-info.java
@@ -16,13 +16,13 @@
  */
 
 /**
- * An API for creating text translation routines from a set of smaller building blocks. Initially created to make it possible for the user to customize the
+ * Deprecated: Provides text translation routines from a set of smaller building blocks. Initially created to make it possible for the user to customize the
  * rules in the StringEscapeUtils class.
  * <p>
  * These classes are immutable, and therefore thread-safe.
  * </p>
  * <p>
- * <strong>Deprecated</strong> As of 3.6, use the Apache Commons Text
+ * <strong>Deprecated</strong> As of <a href="https://commons.apache.org/proper/commons-lang/changes-report.html#a3.6">3.6</a>, use the Apache Commons Text
  * <a href="https://commons.apache.org/proper/commons-text/javadocs/api-release/org/apache/commons/text/translate/package-summary.html"> translate package</a>.
  * </p>
  *