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 * See the License for the specific language governing permissions and
* limitations under the License. * limitations under the License.
*/ */
/** /**
* Provides classes for handling and manipulating text, partly as an extension to {@link java.text}. * 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,
* The classes in this package are, for the most part, intended to be instantiated (i.e. they are not utility classes * intended to be instantiated (i.e. they are not utility classes with lots of static methods).
* 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}. * <p>
* 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> * 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 * @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; 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 * See the License for the specific language governing permissions and
* limitations under the License. * limitations under the License.
*/ */
/** /**
* An API for creating text translation routines from a set of smaller building blocks. Initially created to make it * 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
* possible for the user to customize the rules in the StringEscapeUtils class. * rules in the StringEscapeUtils class.
* <p>These classes are immutable, and therefore thread-safe.</p> * <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 * @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; package org.apache.commons.lang3.text.translate;