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 <[email protected]>
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;
