diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 18d9c28e7..80005caac 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -55,7 +55,7 @@ Getting Started
+ Clearly describe the issue including steps to reproduce when it is a bug.
+ Make sure you fill in the earliest version that you know has the issue.
+ Find the corresponding [repository on GitHub](https://github.com/apache/?query=commons-),
-[fork](https://help.github.com/articles/fork-a-repo/) and check out your forked repository.
+[fork](https://docs.github.com/en/get-started/quickstart/fork-a-repo) and check out your forked repository.
Making Changes
--------------
@@ -106,8 +106,8 @@ Additional Resources
+ [Contributing patches](https://commons.apache.org/patches.html)
+ [Apache Commons Lang JIRA project page][jira]
+ [Contributor License Agreement][cla]
-+ [General GitHub documentation](https://help.github.com/)
-+ [GitHub pull request documentation](https://help.github.com/articles/creating-a-pull-request/)
++ [General GitHub documentation](https://docs.github.com/)
++ [GitHub pull request documentation](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
+ `#apache-commons` IRC channel on `irc.freenode.net`
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index b0a025ddb..26ad4c64d 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -736,7 +736,7 @@ JAVA 9 SUPPORT
==============
Java 9 introduces a new version-string scheme. Details of this new scheme are
-documented in JEP-223 (http://openjdk.java.net/jeps/223). In order to support
+documented in JEP-223 (https://openjdk.org/jeps/223). In order to support
JEP-223 two classes had to be changed:
o org.apache.commons.lang3.JavaVersion
@@ -756,7 +756,7 @@ BUILDING ON JAVA 9
Java 8 introduced the Unicode Consortium's Common Locale Data Repository as
alternative source for locale data. Java 9 will use the CLDR provider as
-default provider for locale data (see http://openjdk.java.net/jeps/252). This
+default provider for locale data (see https://openjdk.org/jeps/252). This
causes an number of locale-sensitive test in Commons Lang to fail. In order
to build Commons Lang 3.5 on Java 9, the locale provider has to be set to
'JRE':
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 9b465ff50..b5ddcc291 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -1105,7 +1105,7 @@ The
According to JRE character
+ * According to JRE character
* encoding names: Every implementation of the Java platform is required to support the following character encodings.
* Consult the release documentation for your implementation to see if any other encodings are supported.
*
Returns whether the named charset is supported.
* *This is similar to + * href="https://docs.oracle.com/javase/8/docs/api/java/nio/charset/Charset.html#isSupported%28java.lang.String%29"> * java.nio.charset.Charset.isSupported(String) but handles more formats
* * @param name the name of the requested charset; may be either a canonical name or an alias, null returns false diff --git a/src/main/java/org/apache/commons/lang3/CharUtils.java b/src/main/java/org/apache/commons/lang3/CharUtils.java index c1703a49e..11cc891c0 100644 --- a/src/main/java/org/apache/commons/lang3/CharUtils.java +++ b/src/main/java/org/apache/commons/lang3/CharUtils.java @@ -37,7 +37,7 @@ public class CharUtils { /** * Linefeed character LF ({@code '\n'}, Unicode 000a). * - * @see JLF: Escape Sequences + * @see JLF: Escape Sequences * for Character and String Literals * @since 2.2 */ @@ -46,7 +46,7 @@ public class CharUtils { /** * Carriage return character CR ('\r', Unicode 000d). * - * @see JLF: Escape Sequences + * @see JLF: Escape Sequences * for Character and String Literals * @since 2.2 */ diff --git a/src/main/java/org/apache/commons/lang3/ClassUtils.java b/src/main/java/org/apache/commons/lang3/ClassUtils.java index 950d5cd7d..2608822b0 100644 --- a/src/main/java/org/apache/commons/lang3/ClassUtils.java +++ b/src/main/java/org/apache/commons/lang3/ClassUtils.java @@ -802,7 +802,7 @@ public class ClassUtils { ** Returns the desired Method much like {@code Class.getMethod}, however it ensures that the returned Method is from a * public class or interface and not from an anonymous inner class. This means that the Method is invokable and doesn't - * fall foul of Java bug 4071957). + * fall foul of Java bug 4071957). *
* *@@ -1269,7 +1269,7 @@ public class ClassUtils { ** Specifically, this method tests whether the type represented by the specified {@link Class} parameter can be * converted to the type represented by this {@link Class} object via an identity conversion widening primitive or - * widening reference conversion. See The Java Language + * widening reference conversion. See The Java Language * Specification, sections 5.1.1, 5.1.2 and 5.1.4 for details. *
* @@ -1310,7 +1310,7 @@ public class ClassUtils { ** Specifically, this method tests whether the type represented by the specified {@link Class} parameter can be * converted to the type represented by this {@link Class} object via an identity conversion widening primitive or - * widening reference conversion. See The Java Language + * widening reference conversion. See The Java Language * Specification, sections 5.1.1, 5.1.2 and 5.1.4 for details. *
* @@ -1406,7 +1406,7 @@ public class ClassUtils { ** Specifically, this method tests whether the type represented by the specified {@link Class} parameter can be * converted to the type represented by this {@link Class} object via an identity conversion widening primitive or - * widening reference conversion. See The Java Language + * widening reference conversion. See The Java Language * Specification, sections 5.1.1, 5.1.2 and 5.1.4 for details. *
* @@ -1453,7 +1453,7 @@ public class ClassUtils { ** Specifically, this method tests whether the type represented by the specified {@link Class} parameter can be * converted to the type represented by this {@link Class} object via an identity conversion widening primitive or - * widening reference conversion. See The Java Language + * widening reference conversion. See The Java Language * Specification, sections 5.1.1, 5.1.2 and 5.1.4 for details. *
* diff --git a/src/main/java/org/apache/commons/lang3/RandomStringUtils.java b/src/main/java/org/apache/commons/lang3/RandomStringUtils.java index 0a57b6e50..2062b1730 100644 --- a/src/main/java/org/apache/commons/lang3/RandomStringUtils.java +++ b/src/main/java/org/apache/commons/lang3/RandomStringUtils.java @@ -31,7 +31,7 @@ import java.util.concurrent.ThreadLocalRandom; * RandomStringGenerator instead. * *The Apache Commons project provides - * Commons RNG dedicated to pseudo-random number generation, that may be + * Commons RNG dedicated to pseudo-random number generation, that may be * a better choice for applications with more stringent requirements * (performance and/or correctness).
* diff --git a/src/main/java/org/apache/commons/lang3/RandomUtils.java b/src/main/java/org/apache/commons/lang3/RandomUtils.java index 59591c5df..e77c12fea 100644 --- a/src/main/java/org/apache/commons/lang3/RandomUtils.java +++ b/src/main/java/org/apache/commons/lang3/RandomUtils.java @@ -26,7 +26,7 @@ import java.util.concurrent.ThreadLocalRandom; * *Please note that the Apache Commons project provides a component * dedicated to pseudo-random number generation, namely - * Commons RNG, that may be + * Commons RNG, that may be * a better choice for applications with more stringent requirements * (performance and/or correctness).
* diff --git a/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java b/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java index a82f71cad..3233ad612 100644 --- a/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java +++ b/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java @@ -493,7 +493,7 @@ public class StringEscapeUtils { *The only difference between Java strings and Json strings * is that in Json, forward-slash (/) is escaped.
* - *See http://www.ietf.org/rfc/rfc4627.txt for further details.
+ *See https://www.ietf.org/rfc/rfc4627.txt for further details.
* *Example:
*@@ -576,11 +576,11 @@ public class StringEscapeUtils { * @param input the {@link String} to escape, may be null * @return a new escaped {@link String}, {@code null} if null string input * - * @see ISO Entities - * @see HTML 3.2 Character Entities for ISO Latin-1 - * @see HTML 4.0 Character entity references - * @see HTML 4.01 Character References - * @see HTML 4.01 Code positions + * @see ISO Entities + * @see HTML 3.2 Character Entities for ISO Latin-1 + * @see HTML 4.0 Character entity references + * @see HTML 4.01 Character References + * @see HTML 4.01 Code positions * * @since 3.0 */ @@ -757,8 +757,8 @@ public class StringEscapeUtils { *If the value does not contain a comma, newline or double quote, then the * String value is returned unchanged.
* - * see Wikipedia and - * RFC 4180. + * see Wikipedia and + * RFC 4180. * * @param input the input CSV column String, may be null * @return the input String, enclosed in double quotes if the value contains a comma, @@ -782,8 +782,8 @@ public class StringEscapeUtils { *If the value is not enclosed in double quotes, or is and does not contain a * comma, newline or double quote, then the String value is returned unchanged.
* - * see Wikipedia and - * RFC 4180. + * see Wikipedia and + * RFC 4180. * * @param input the input CSV column String, may be null * @return the input String, with enclosing double quotes removed and embedded double diff --git a/src/main/java/org/apache/commons/lang3/StringUtils.java b/src/main/java/org/apache/commons/lang3/StringUtils.java index b1f198fb1..a4a60738a 100644 --- a/src/main/java/org/apache/commons/lang3/StringUtils.java +++ b/src/main/java/org/apache/commons/lang3/StringUtils.java @@ -156,7 +156,7 @@ public class StringUtils { /** * A String for linefeed LF ("\n"). * - * @see JLF: Escape Sequences + * @see JLF: Escape Sequences * for Character and String Literals * @since 3.2 */ @@ -165,7 +165,7 @@ public class StringUtils { /** * A String for carriage return CR ("\r"). * - * @see JLF: Escape Sequences + * @see JLF: Escape Sequences * for Character and String Literals * @since 3.2 */ @@ -2250,7 +2250,7 @@ public class StringUtils { * Winkler increased this measure for matching initial characters. * *This implementation is based on the Jaro Winkler similarity algorithm - * from http://en.wikipedia.org/wiki/Jaro%E2%80%93Winkler_distance.
+ * from https://en.wikipedia.org/wiki/Jaro%E2%80%93Winkler_distance. * ** StringUtils.getJaroWinklerDistance(null, null) = IllegalArgumentException @@ -2304,8 +2304,8 @@ public class StringUtils { * insertion or substitution). * *The implementation uses a single-dimensional array of length s.length() + 1. See - * - * http://blog.softwx.net/2014/12/optimizing-levenshtein-algorithm-in-c.html for details.
+ * + * https://blog.softwx.net/2014/12/optimizing-levenshtein-algorithm-in-c.html for details. * ** StringUtils.getLevenshteinDistance(null, *) = IllegalArgumentException @@ -2397,7 +2397,7 @@ public class StringUtils { * *This implementation follows from Algorithms on Strings, Trees and Sequences by Dan Gusfield * and Chas Emerick's implementation of the Levenshtein distance algorithm from - * http://www.merriampark.com/ld.htm
+ * http://www.merriampark.com/ld.htm * ** StringUtils.getLevenshteinDistance(null, *, *) = IllegalArgumentException @@ -5471,7 +5471,7 @@ public class StringUtils { /** * ** *@@ -5480,7 +5480,7 @@ public class StringUtils { * and then replacing sequences of whitespace characters by a single space. *
* In XML Whitespace characters are the same as those allowed by the S production, which is S ::= (#x20 | #x9 | #xD | #xA)+ + * href="https://www.w3.org/TR/REC-xml/#NT-S">S production, which is S ::= (#x20 | #x9 | #xD | #xA)+ ** Java's regexp pattern \s defines whitespace as [ \t\n\x0B\f\r] * @@ -5503,7 +5503,7 @@ public class StringUtils { * @see Pattern * @see #trim(String) * @see http://www.w3.org/TR/xpath/#function-normalize-space + * href="https://www.w3.org/TR/xpath/#function-normalize-space">https://www.w3.org/TR/xpath/#function-normalize-space * @param str the source String to normalize whitespaces from, may be null * @return the modified string with whitespace normalized, {@code null} if null String input * @@ -6207,7 +6207,7 @@ public class StringUtils { *
Note: this method does not support padding with - * Unicode Supplementary Characters + * Unicode Supplementary Characters * as they require a pair of {@code char}s to be represented. * If you are needing to support full I18N of your applications * consider using {@link #repeat(String, int)} instead. diff --git a/src/main/java/org/apache/commons/lang3/SystemUtils.java b/src/main/java/org/apache/commons/lang3/SystemUtils.java index 2b9bec638..1555051bb 100644 --- a/src/main/java/org/apache/commons/lang3/SystemUtils.java +++ b/src/main/java/org/apache/commons/lang3/SystemUtils.java @@ -1084,9 +1084,8 @@ public class SystemUtils { // ----------------------------------------------------------------------- // These MUST be declared after those above as they depend on the // values being set up - // OS names from http://www.vamphq.com/os.html - // Selected ones included - please advise dev@commons.apache.org - // if you want another added or a mistake corrected + // Please advise dev@commons.apache.org if you want another added + // or a mistake corrected /** *
diff --git a/src/main/java/org/apache/commons/lang3/Validate.java b/src/main/java/org/apache/commons/lang3/Validate.java index 8a5292e7a..c194f8882 100644 --- a/src/main/java/org/apache/commons/lang3/Validate.java +++ b/src/main/java/org/apache/commons/lang3/Validate.java @@ -32,7 +32,7 @@ import java.util.regex.Pattern; * * *
All exceptions messages are - * format strings + * format strings * as defined by the Java platform. For example:
* *diff --git a/src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java b/src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java index 67c8cb434..f0e6862ec 100644 --- a/src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java +++ b/src/main/java/org/apache/commons/lang3/builder/EqualsBuilder.java @@ -34,7 +34,7 @@ import org.apache.commons.lang3.tuple.Pair; * *This class provides methods to build a good equals method for any * class. It follows rules laid out in - * Effective Java + * Effective Java * , by Joshua Bloch. In particular the rule for comparing {@code doubles}, * {@code floats}, and arrays can be tricky. Also, making sure that * {@code equals()} and {@code hashCode()} are consistent can be diff --git a/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java b/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java index fe87282cf..c2556fa41 100644 --- a/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java +++ b/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java @@ -37,7 +37,7 @@ import org.apache.commons.lang3.Validate; * *
* This class enables a good {@code hashCode} method to be built for any class. It follows the rules laid out in - * the book Effective Java by Joshua Bloch. Writing a + * the book Effective Java by Joshua Bloch. Writing a * good {@code hashCode} method is actually quite difficult. This class aims to simplify the process. *
* diff --git a/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java b/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java index 0e3b6c831..7da31a306 100644 --- a/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java +++ b/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java @@ -157,7 +157,7 @@ public abstract class ToStringStyle implements Serializable { * when calling {@code toString()} on them. * * @since 3.4 - * @see json.org + * @see json.org */ public static final ToStringStyle JSON_STYLE = new JsonToStringStyle(); @@ -2246,7 +2246,7 @@ public abstract class ToStringStyle implements Serializable { * * * @since 3.4 - * @see json.org + * @see json.org */ private static final class JsonToStringStyle extends ToStringStyle { diff --git a/src/main/java/org/apache/commons/lang3/concurrent/CircuitBreaker.java b/src/main/java/org/apache/commons/lang3/concurrent/CircuitBreaker.java index 3299ac28b..72e84260c 100644 --- a/src/main/java/org/apache/commons/lang3/concurrent/CircuitBreaker.java +++ b/src/main/java/org/apache/commons/lang3/concurrent/CircuitBreaker.java @@ -19,7 +19,7 @@ package org.apache.commons.lang3.concurrent; /** ** An interface describing a Circuit Breaker component. + * href="https://martinfowler.com/bliki/CircuitBreaker.html">Circuit Breaker component. *
** A circuit breaker can be used to protect an application against unreliable diff --git a/src/main/java/org/apache/commons/lang3/concurrent/EventCountCircuitBreaker.java b/src/main/java/org/apache/commons/lang3/concurrent/EventCountCircuitBreaker.java index 66ae7a375..3c48ced44 100644 --- a/src/main/java/org/apache/commons/lang3/concurrent/EventCountCircuitBreaker.java +++ b/src/main/java/org/apache/commons/lang3/concurrent/EventCountCircuitBreaker.java @@ -25,7 +25,7 @@ import java.util.concurrent.atomic.AtomicReference; /** *
* A simple implementation of the Circuit Breaker pattern + * href="https://martinfowler.com/bliki/CircuitBreaker.html">Circuit Breaker pattern * that counts specific events. *
*diff --git a/src/main/java/org/apache/commons/lang3/concurrent/ThresholdCircuitBreaker.java b/src/main/java/org/apache/commons/lang3/concurrent/ThresholdCircuitBreaker.java index cd7e09852..eb3cd679a 100644 --- a/src/main/java/org/apache/commons/lang3/concurrent/ThresholdCircuitBreaker.java +++ b/src/main/java/org/apache/commons/lang3/concurrent/ThresholdCircuitBreaker.java @@ -21,7 +21,7 @@ import java.util.concurrent.atomic.AtomicLong; /** *
* A simple implementation of the Circuit Breaker pattern + * href="https://martinfowler.com/bliki/CircuitBreaker.html">Circuit Breaker pattern * that opens if the requested increment amount is greater than a given threshold. *
* diff --git a/src/main/java/org/apache/commons/lang3/math/Fraction.java b/src/main/java/org/apache/commons/lang3/math/Fraction.java index 71dfce41a..20addc947 100644 --- a/src/main/java/org/apache/commons/lang3/math/Fraction.java +++ b/src/main/java/org/apache/commons/lang3/math/Fraction.java @@ -233,7 +233,7 @@ public final class Fraction extends Number implements Comparable{ /** * Creates a {@link Fraction} instance from a {@code double} value.
* - *This method uses the + *
* *This method uses the * continued fraction algorithm, computing a maximum of * 25 convergents and bounding the denominator by 10,000.
* diff --git a/src/main/java/org/apache/commons/lang3/math/IEEE754rUtils.java b/src/main/java/org/apache/commons/lang3/math/IEEE754rUtils.java index 8f5685648..898614330 100644 --- a/src/main/java/org/apache/commons/lang3/math/IEEE754rUtils.java +++ b/src/main/java/org/apache/commons/lang3/math/IEEE754rUtils.java @@ -21,7 +21,7 @@ import org.apache.commons.lang3.Validate; /** *Provides IEEE-754r variants of NumberUtils methods.
* - *See: http://en.wikipedia.org/wiki/IEEE_754r
+ *See: https://en.wikipedia.org/wiki/IEEE_754r
* * @since 2.4 */ diff --git a/src/main/java/org/apache/commons/lang3/math/package-info.java b/src/main/java/org/apache/commons/lang3/math/package-info.java index bd56cddce..854711d76 100644 --- a/src/main/java/org/apache/commons/lang3/math/package-info.java +++ b/src/main/java/org/apache/commons/lang3/math/package-info.java @@ -17,7 +17,7 @@ /** *Extends {@link java.math} for business mathematical classes. * This package is intended for business mathematical use, not scientific use. - * See Commons Math for a more complete set of mathematical classes. + * See Commons Math for a more complete set of mathematical classes. * These classes are immutable, and therefore thread-safe.
* *Although Commons Math also exists, some basic mathematical functions are contained within Lang. diff --git a/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java b/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java index dc2c5e3fc..a530fcfdf 100644 --- a/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java +++ b/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java @@ -704,7 +704,7 @@ public class FieldUtils { * if the field is {@code null} * @deprecated As of Java 12, we can no longer drop the {@code final} modifier, thus * rendering this method obsolete. The JDK discussion about this change can be found - * here: http://mail.openjdk.java.net/pipermail/core-libs-dev/2018-November/056486.html + * here: https://mail.openjdk.java.net/pipermail/core-libs-dev/2018-November/056486.html * @since 3.3 */ @Deprecated 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 index 67ef622e5..520455418 100644 --- a/src/main/java/org/apache/commons/lang3/text/translate/EntityArrays.java +++ b/src/main/java/org/apache/commons/lang3/text/translate/EntityArrays.java @@ -148,7 +148,7 @@ public class EntityArrays { private static final String[][] ISO8859_1_UNESCAPE = invert(ISO8859_1_ESCAPE); /** - * Mapping to escape additional character entity + * Mapping to escape additional character entity * references. Note that this must be used with {@link #ISO8859_1_ESCAPE()} to get the full list of * HTML 4.0 character entities. * @return the mapping table diff --git a/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java b/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java index 88fcdd1ac..ec9b9e91a 100644 --- a/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java +++ b/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java @@ -264,7 +264,7 @@ public class DurationFormatUtils { * choosing March -> February = 1 month and then calculating days * backwards.
* - *For more control, the Joda-Time + *
For more control, the Joda-Time * library is recommended.
* * @param startMillis the start of the duration diff --git a/src/main/java/org/apache/commons/lang3/time/FastDateParser.java b/src/main/java/org/apache/commons/lang3/time/FastDateParser.java index 6f003edb8..0378e5364 100644 --- a/src/main/java/org/apache/commons/lang3/time/FastDateParser.java +++ b/src/main/java/org/apache/commons/lang3/time/FastDateParser.java @@ -59,7 +59,7 @@ import org.apache.commons.lang3.LocaleUtils; * This class is especially useful in multi-threaded server environments. * {@link SimpleDateFormat} is not thread-safe in any JDK version, * nor will it be as Sun has closed the - * bug/RFE. + * bug/RFE. *Only parsing is supported by this class, but all patterns are compatible with diff --git a/src/site/resources/lang2-lang3-clirr-report.html b/src/site/resources/lang2-lang3-clirr-report.html index e2aaf12b5..783077600 100644 --- a/src/site/resources/lang2-lang3-clirr-report.html +++ b/src/site/resources/lang2-lang3-clirr-report.html @@ -59,9 +59,9 @@ limitations under the License. Last Published: 13 July 2011 | Version: 3.0 -
ApacheCon +ApacheCon | - Apache + Apache | Commons @@ -182,7 +182,7 @@ limitations under the License. Home- License + License Components @@ -209,32 +209,32 @@ limitations under the License. Releasing Components - Wiki + Wiki ASF
- - + + - - + + @@ -250,7 +250,7 @@ limitations under the License.
- - How the ASF works + How the ASF works
- - Get Involved + Get Involved
- - Developer Resources + Developer Resources
- - Sponsorship + Sponsorship
- - Thanks + Thanks