[commons-lang] branch master updated: @deprecated in package info files generates a warning in Java 21

[gg...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-lang.git


The following commit(s) were added to refs/heads/master by this push:
     new 181ba1852 @deprecated in package info files generates a warning in Java 21
181ba1852 is described below

commit 181ba18528dad981e98f30860ef65e1c66f6eb51
Author: Gary Gregory <ga...@gmail.com>
AuthorDate: Fri Oct 20 15:24:58 2023 -0400

    @deprecated in package info files generates a warning in Java 21
---
 .../apache/commons/lang3/text/package-info.java    | 23 +++++++++++++---------
 .../commons/lang3/text/translate/package-info.java | 16 +++++++++------
 2 files changed, 24 insertions(+), 15 deletions(-)

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
index 29dc886fa..532c88d21 100644
--- a/src/main/java/org/apache/commons/lang3/text/package-info.java
+++ b/src/main/java/org/apache/commons/lang3/text/package-info.java
@@ -14,17 +14,22 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+
 /**
- *  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>Amongst other classes, the text package provides a replacement for {@link java.lang.StringBuffer} named {@link org.apache.commons.lang3.text.StrBuilder}, a class for substituting variables within a String named {@link org.apache.commons.lang3.text.StrSubstitutor} and a replacement for {@link java.util.StringTokenizer} named {@link org.apache.commons.lang3.text.StrTokenizer}.
- * While somewhat ungainly, the {@code Str} prefix has been used to ensure we don't clash with any current or future standard Java classes.</p>
+ * 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>
+ * Amongst other classes, the text package provides a replacement for {@link java.lang.StringBuffer} named {@link org.apache.commons.lang3.text.StrBuilder}, a
+ * class for substituting variables within a String named {@link org.apache.commons.lang3.text.StrSubstitutor} and a replacement for
+ * {@link java.util.StringTokenizer} named {@link org.apache.commons.lang3.text.StrTokenizer}. While somewhat ungainly, the {@code Str} prefix has been used to
+ * ensure we don't clash with any current or future standard Java classes.
+ * </p>
+ * <p>
+ * <b>Deprecated</b> As of 3.6, 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>
+ * 
  * @since 2.1
- * @deprecated As of 3.6, 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>.
  */
 package org.apache.commons.lang3.text;
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
index 7c507cac2..1f959e33f 100644
--- 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
@@ -14,14 +14,18 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+
 /**
- *  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 rules in the StringEscapeUtils class.
- * <p>These classes are immutable, and therefore thread-safe.</p>
+ * 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
+ * rules in the StringEscapeUtils class.
+ * <p>
+ * These classes are immutable, and therefore thread-safe.
+ * </p>
+ * <p>
+ * <b>Deprecated</b> As of 3.6, 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>
  *
  * @since 3.0
- * @deprecated As of 3.6, 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>.
  */
 package org.apache.commons.lang3.text.translate;