Apache
/
commons-lang
mirror of https://github.com/apache/commons-lang.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

@deprecated in package info files generates a warning in Java 21

This commit is contained in:
Gary Gregory 2023-10-20 15:24:58 -04:00
parent 9840b9df57
commit 181ba18528
2 changed files with 24 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
src/main/java/org/apache/commons/lang3/text/package-info.java
View File

@ -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).
* 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>
* 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;

16
src/main/java/org/apache/commons/lang3/text/translate/package-info.java
View File

@ -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;