Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Apache Commons Lang 3.21.0 Release Notes
----------------------------------------

The Apache Commons Lang team is pleased to announce the release of Apache Commons Lang 3.21.0.

Apache Commons Lang is a package of Java utility classes for the Java lang packages,
classes that could be considered standard to justify their existence in java.lang.

The code is tested using the latest revision of the JDK for supported LTS releases: 8, 11, 17, 21, and 25.
See https://github.com/apache/commons-lang/blob/master/.github/workflows/maven.yml

Please ensure your build environment is up-to-date and kindly report any build issues.

Starting with Commons Lang 3.9, we target Java 8 and use those features.

For advice on upgrading from 2.x to 3.x, see https://commons.apache.org/lang/article3_0.html

This is a feature and maintenance release. Java 8 or later is required.

Changes in this version include:

New features:
*            Add JavaVersion.JAVA_27. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_27. Thanks to Gary Gregory.
*            JavaVersion.get(String) now support Java 26, 27 and 28. Thanks to Gary Gregory.
* LANG-1810: Deprecate ArrayUtils.SOFT_MAX_ARRAY_LENGTH in favor of SAFE_MAX_ARRAY_LENGTH #1559. Thanks to Yelim Koo, Gary Gregory.
*            Add long support to BitField #1561. Thanks to Gary Gregory, Theodora Anastasia Lazaridou.
*            Add ArrayUtils.getDimensions(Object). Thanks to Gary Gregory.
* LANG-1707: Add ArrayUtils.concat() methods for concatenating multiple arrays #1519. Thanks to Ivan Malutin, Gilles Sadowski, Gary Gregory.
*            Add FailableConsumer.accept(FailableConsumer, T) (#1641). Thanks to Gary Gregory.
*            Add AutoCloseables #1643. Thanks to Gary Gregory.
* LANG-1711: Make object accessibility optional with AbstractReflection.AbstractBuilder.setForceAccessible(boolean) (#1558). Thanks to Gary Gregory.
*            Add ArrayFill.clear(char[]) (#1667). Thanks to Gary Gregory.
*            Add DurationUtils.toMillisLong(Duration) (#1679). Thanks to Gary Gregory.
*            Add Instants.toEpochMillis(Instant) (#1680). Thanks to Gary Gregory.
*            Add StringUtils.trimAsciiControl(String) (#1681). Thanks to Gary Gregory.
*            Add Instants.toMillisSince(Instant) (#1683). Thanks to Gary Gregory.
*            Add CharUtils isHex(int), isAsciiNumeric(int), isOctal(int) (#1685). Thanks to Gary Gregory.
*            Add and use Instants.toInstant(Instant[, Instant]) (#1690). Thanks to Gary Gregory.
* LANG-1833: Handle ParsePosition index beyond source string length cleanly (#1757). Thanks to Maksym Korshun.
*            Add ClassUtils.getClassStrict(ClassLoader, String, boolean) (f020). Thanks to Gary Gregory.
*            Add ClassUtils.getClassStrict(String) (f020). Thanks to Gary Gregory.
*            Fix TypeUtils.isAssignable() for wildcards with multiple upper bounds (#1782). Thanks to Gary Gregory, gaurav kumar pandey.
*            Add JavaVersion.JAVA_28. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_28. Thanks to Gary Gregory.

Fixed Bugs:
*            Stop ExtendedMessageFormat seekNonWs reading past the pattern end. Thanks to Javid Khan, Gary Gregory.
*            Fix spelling and grammar in StringUtils #1486. Thanks to ThrawnCA.
*            Add ConversionTest assertions to increase coverage #1489. Thanks to Michael Hausegger, Gary Gregory.
*            Use Class<?> instead of Class<? extends Object> in MethodUtils #1491. Thanks to Boda65665, Gary Gregory.
*            ClassUtils now throws IllegalArgumentException if a class name represents an array with more dimensions than the JVM supports, 255:
             getClass(ClassLoader, String, boolean),
             ClassUtils.getClass(ClassLoader, String),
             ClassUtils.getClass(String, boolean),
             ClassUtils.getClass(String),
             #1494. Thanks to Gary Gregory, Arnout Engelen, Piotr P. Karwasz, Vladimir Sitnikov, Gilles Sadowski.
*            ClassUtils now throws IllegalArgumentException if a class name length is greater than 65,535:
             getClass(ClassLoader, String, boolean),
             ClassUtils.getClass(ClassLoader, String),
             ClassUtils.getClass(String, boolean),
             ClassUtils.getClass(String),
             #1495. Thanks to Gary Gregory, Arnout Engelen, Piotr P. Karwasz, Vladimir Sitnikov, Gilles Sadowski.
*            Fix console compiler warning: TypeUtils.java:[361,33] non-varargs call of varargs method with inexact argument type for last parameter. Thanks to Gary Gregory.
*            Fix console compiler warning: ReflectionDiffBuilderTest.java:[172,52] non-varargs call of varargs method with inexact argument type for last parameter. Thanks to Gary Gregory.
*            Fix Apache RAT plugin console warnings. Thanks to Gary Gregory.
* LANG-1793: Fix Javadoc description in CharUtils.isAsciiAlphanumeric() #1501. Thanks to IcoreE.
* LANG-1794: Fix Javadoc for RandomUtils.secure(), it incorrectly mentions securerandom.strongAlgorithms #1503. Thanks to IcoreE.
*            Fix NullPointerException in ReflectionDiffBuilder.getExcludeFieldNames() when instance created with ReflectionDiffBuilder.ReflectionDiffBuilder(T, T, ToStringStyle). Thanks to Gary Gregory.
*            Fail-fast for a null DiffBuilder in ReflectionDiffBuilder.ReflectionDiffBuilder(DiffBuilder, String[]) instead of getting a NullPointerException in ReflectionDiffBuilder instance methods. Thanks to Gary Gregory.
*            Fix NumberUtilsTest#testMaxDouble() and testMaxFloat() #4959. Thanks to Michael Hausegger, Gary Gregory.
* LANG-1797: Fix Javadoc for IEEE754rUtils.max(float...) and IEEE754rUtils.max(double...). Thanks to IcoreE.
* LANG-1798: Fix StringUtilsSubstringTest.testCountMatches_char() to call the correct method. Thanks to IcoreE, Gary Gregory.
* LANG-1799: Make private static variables final in RandomStringUtils #1513. Thanks to IcoreE, Gary Gregory.
*            Speed up StringUtils.getDigits(String) #1515. Thanks to David Du, Gary Gregory.
*            Remove redundant length check in StringUtils.isBlank(CharSequence) #1516. Thanks to David Du, Gary Gregory.
* LANG-1800: Incorrect grammar and unclear wording in RandomStringUtils#random method #1520. Thanks to IcoreE.
* LANG-1802: Fix collision in CharRange.hashCode(). Thanks to Gary Gregory, IcoreE.
*            Fix race condition in Fraction.hashCode(). Thanks to Gary Gregory.
*            Fix race condition in Range.hashCode(). Thanks to Gary Gregory.
*            Document safer deserialization option in Javadoc for SerializationUtils. Thanks to Gary Gregory, Akshat_Agg.
* LANG-1729: NumberUtils.isParsable(String) returns true for full width Unicode digits for inputs with a decimal point. Thanks to Gary Gregory, Andrei Anischevici, Akshat_Agg.
* LANG-1803: Fix incorrect method invocation in ObjectUtilsTest and Javadoc reference in RandomStringUtils. Thanks to IcoreE.
* LANG-1695: Allow trailing decimal point in NumberUtils.isParsable(String) #1531. Thanks to Guillaume Nodet, Harshit Goel, Gary Gregory.
* LANG-1804: Fix CharSet#getInstance returns null instead of EMPTY when input setStrs is null #1530. Thanks to IcoreE, Gary Gregory.
*            Speedup CharSequenceUtils.toCharArray(CharSequence) for StringBuilder input: 160-205% improvement (2-3x faster), see CharSequenceUtilsBenchmark. Thanks to Gary Gregory.
*            Speedup CharSequenceUtils.toCharArray(CharSequence) for StringBuffer input: 300-4,250% improvement (4-44x faster), see CharSequenceUtilsBenchmark. Thanks to Gary Gregory.
*            Speedup CharSequenceUtils.toCharArray(CharSequence) for String input: ~1-2% improvement (essentially identical). Thanks to Gary Gregory.
*            Streamline StringUtils.truncate(String, int, int). Thanks to Gary Gregory.
*            Fix Javadoc comma spacing #1538. Thanks to Gary Gregory, sekharchowdary774.
* LANG-1807: Make private static variables final in RandomUtils. Thanks to Zhongxin Yan, Gary Gregory.
* LANG-1448: Javadoc: Normalize some varargs examples. Thanks to David W. Burhans, Gary Gregory, kamGP92.
* LANG-1805: Speedup StringUtils.join(AllPrimitiveTypes[], char, int, int), see StringUtilsJoinBenchmark, based on #1532. Also better StringBuilder allocation Thanks to Gary Gregory, jher235.
* LANG-1749: TypeUtils.isAssignable returns a wrong result for ParameterizedType when raw class is "Class" #1548. Thanks to jinwoo choi, Gary Gregory, YuMing Ma, Ivan ?ari?.
* LANG-1700: Improve handling of parameterized types and variable unrolling. Thanks to seokhyeon moon, Gary Gregory, Ivan ?ari?.
* LANG-1811: ArrayUtils.shuffle() throws NullPointerException for null array input. Thanks to Raju Gupta, Gary Gregory.
*            [javadoc] Fix incorrect exception type in CharUtils Javadoc examples #1563. Thanks to Dennis Ginter, Gary Gregory.
* LANG-1806: [javadoc] Fix incorrect class names in RegExUtils Javadoc examples #1564. Thanks to Dennis Ginter, Gary Gregory.
*            NumberUtils.isParsable("1.f") should return true #1560. Thanks to Gary Gregory, Jagdish Singh Bisht.
*            Simplify literal assignments in ArrayFillTest #1567. Thanks to Gary Gregory, David Du.
*            Make ArrayUtils methods implementation consistent with other overloads #1568. Thanks to Gary Gregory, David Du.
*            Fix handling of null marker in StringUtils.abbreviate(String, String, int, int) #1571. Thanks to ThrawnCA, Gary Gregory.
*            Better exception messages from FastDateParser.parse(String). Thanks to Gary Gregory.
*            Simplify NumberUtils.isParsable(String) #1570. Thanks to Gary Gregory, David Du.
*            RandomStringUtils.random() methods may not return when asked to generate only letters or only numbers while provided with a range that contains neither. Thanks to Gary Gregory.
*            Fix Javadoc parameter comments in StringUtils.truncate() methods #1536. Thanks to Gary Gregory, Akshat Upadhyay.
*            Improve test coverage for TypeUtils.isAssignable() #1574. Thanks to Gary Gregory, Dhaneesh.M.
*            Improve branch coverage for Processor (isAarch64, isRISCV); add ProcessorTest #1578. Thanks to Gary Gregory, Dhaneesh.M.
*            Fix ClassNotFoundException message in ClassUtils.getClass(String) #1577. Thanks to Gary Gregory, ?????.
*            Fix Javadoc in DoubleRange.of(Double, Double) to reflect actual exception type thrown #1581. Thanks to Ivan Ponomarev.
* LANG-1452: RecursiveToStringStyle and MultilineRecursiveToStringStyle shouldn't recurse into a java.math.BigDecimal #1584. Thanks to Gary Gregory, Aleksey Novozhilov, Sara.
* LANG-1814: ArrayUtils.subarray(..) may overflow index arithmetic and violate contract for extreme index values. Thanks to Ivan Ponomarev.
* LANG-1816: ArrayUtils contains/indexOf/indexesOf with tolerance fail to match NaN values #1589. Thanks to Ivan Ponomarev, Gary Gregory.
*            Fix StringIndexOutOfBoundsException message in StrBuilder.append(char[], int, int). Thanks to Ivan Ponomarev, Gary Gregory.
* LANG-1818: Fix ClassUtils.getShortClassName(Class) to correctly handle $ in valid class names #1591. Thanks to Ivan Ponomarev, Gary Gregory.
*            ThreadUtils.sleepQuietly(Duration) now restores the current thread's interrupt flag when catching InterruptedException. Thanks to Ivan Ponomarev, Gary Gregory.
* LANG-1817: UncheckedFutureImpl clears thread interrupt status when wrapping InterruptedException #1590. Thanks to Ivan Ponomarev, Gary Gregory.
*            Fix StringUtils.abbreviate(String, String, int) contract violations #1572. Thanks to ThrawnCA, Gary Gregory.
*            Add test coverage for negative-day adjustment in DurationFormatUtils #1596. Thanks to TK_ENDO, Arnout Engelen, Gary Gregory.
*            [Javadoc] Add usage examples to CharSet.contains(char) #1605. Thanks to Mohammad Bireybi, Gary Gregory.
*            CharSet now maintains iteration order. Thanks to Gary Gregory.
* LANG-771:  DateUtils.ceiling does not behave correctly for dates on the boundaries. Thanks to Ryan Holmes, Makarand Hinge, Gary Gregory.
* LANG-1819: [LANG-] Javadoc ArrayUtils.removeAll() null input behavior #1614. Thanks to Partha Protim Paul, Gary Gregory.
* LANG-1813: ArrayUtils#hashCode() Javadoc incorrectly states ?null returns zero? (actual result is 629). Thanks to Ivan Ponomarev, Gary Gregory.
*            Deprecate Validate.Validate(). Thanks to Gary Gregory.
* LANG-1820: [javadoc] Fix ObjectUtils.anyNull(Object) for empty arrays. Thanks to Partha Paul, Gary Gregory.
*            Fix StopWatch's stopInstant match stopTimeNanos when split is called #1610. Thanks to Lars Helge Øverland, Gary Gregory.
*            Fix NullPointerException in StopWatch.getStopTime(). Thanks to Gary Gregory.
*            Add "ppc64le" to ArchUtils #1625. See https://bugs.gentoo.org/972590
             Bug 972590 - dev-java/commons-lang-3.20.0:
             java.lang.NullPointerException: Cannot invoke
             "org.apache.commons.lang3.arch.Processor.toString()" because "<local1>" Thanks to Volkmar W. Pogatzki, Gary Gregory.
* LANG-1821: NumberUtils.isCreatable(String) should match NumberUtils.createNumber(String), exactly #1626. Thanks to FloydDsilva, Gary Gregory, Rob Tompkins.
*            NumberUtils.isCreatable fails for hexadecimal numbers with long type qualifier. Thanks to ????, Gary Gregory.
*            NumberUtils.createNumber() performance: Short-circuit check based on pre-derived candidate Double #1628. Thanks to ax1nch, Gary Gregory.
* LANG-1823: LocaleUtils.toLocale cannot parse valid JDK Locale string containing '#' #1630. Thanks to ????, Gary Gregory.
* LANG-879:  LocaleUtils test fails with new Locale "ja_JP_JP_#u-ca-japanese" of JDK7. Thanks to Matthew T. Adams, Gary Gregory.
*            Fix typo in SystemProperties.JDK_XML_ENTITY_REPLACEMENT_LIMIT (#1631). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            Recompute Range cached hash codes on deserialization while retaining endpoint and comparator validation (#1633). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            Harden Fraction.readObject() to reject bad cached hash code (#1634). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            NumberUtils.createNumber(String): Float shortcut can bypass exact decimal parsing (#1635). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            StringUtils.joins() for primitive types can throw OOME before index check (#1636). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            Annotation lookup in MethodUtils.getAnnotation(Method, Class, boolean, boolean) matches unrelated overloads via assignable-parameter resolution (#1637). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            RandomStringUtils.random(...): A custom chars array throws IllegalArgumentException because validation loops treat the loop index as a char code point instead of an index into the chars array (#1638). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            RandomStringUtils.random(...): Can hang when the specified [start, end) range contains ONLY rejected code points (UNASSIGNED, PRIVATE_USE, SURROGATE). The loop increments count and retries indefinitely (#1638). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            TimedSemaphore.shutdown() must wake threads blocked in acquire() (#1639). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            NaN bypass in primitive double range validators (#1640). Thanks to Omkhar Arasaratnam, Gary Gregory.
* LANG-1826: StringUtils.repeat(String, [String,] int) now throws IllegalArgumentException instead of NegativeArraySizeException (#1644). Thanks to Cyl, Gary Gregory, Piotr Karwasz.
* LANG-1825: EqualsBuilder.reflectionAppend ttries to set visibility on excluded fields #1647. Thanks to Daniel Skiles, Gary Gregory.
*            ToStringStyle.appendDetail(StringBuffer,String,Collection) bypass cycle registry. #1648. Thanks to Omkhar Arasaratnam, Gary Gregory.
*            ToStringStyle.appendDetail(StringBuffer,String,Map) bypass cycle registry. #1648. Thanks to Gary Gregory.
*            WordUtils.wrap() zero-width wrapOn regex match causes infinite loop (#1649).WordUtils.wrap() zero-width wrapOn regex match causes infinite loop (#1649). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            HashCodeBuilder.append(Object) StackOverflowError on mutually-referential objects (#1650). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            AtomicSafeInitializer.get() busy-spin without yield burns CPU during slow initialization (#1651). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            StrBuilder.readFrom(Readable) exposes stale internal buffer to Readable parameter (#1652). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            EqualsBuilder.reflectionEquals() array branch missing cycle guard causes stack overflow on self-referential Object arrays (#1653). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            WordUtils.wrap() leaves separator characters in the output when the wrapOn regex match is longer than one character (#1655). Thanks to Piotr Karwasz.
*            StringUtils.indexOfAny(CharSequence, int, char...) should not throw for a bad index (#1656). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            StrBuilder.deleteImpl(int, int, int) doesn't clear its unused bytes. (#1654). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            LocaleUtils.parseLocale(String) operator precedence bug allows invalid language with numeric country (#1658). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            DurationUtils.toMillisInt() throws ArithmeticException on long overflows before clamping (#1657). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            FastDatePrinter WeekYear rule calls Calendar.getWeekYear() may throw UnsupportedOperationException (#1659). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            DateUtils.parseDateWithLeniency() doesn't reset its time zone (#1660). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            FormattableUtils.append re-parses literal output as format string (#1661). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            ClassUtils.getShortClassName(String) can throw NoClassDefFoundError on malformed inner classes (#1665). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            TimeZones.GMT is a mutable public static final field (#1666). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            CompareToBuilder lacks cycle guard on Object[] recursion. (#1669). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            ClassUtils.toCleanName(String) resolves malformed array suffixes (#1670). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            StrBuilder.setLength(int) shrink-branch leaves residual chars in buffer tail (#1671). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            StrBuilder.replaceImpl() shrink-branch leaves residual chars in buffer tail (#1672). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            NumericEntityUnescaper.translate() throws IllegalArgumentException for values out of range (#1673). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            FastTimeZone.getGmtTimeZone() Javadoc promises null on no-match; regex always matches (#1674). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            Range.readObject() does not null-check comparator, minimum, or maximum (#1675). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            Make the StopWatch more reliable for tracking nanos, adjust suspend test (#1677). Thanks to Gary Gregory.
* LANG-1801: RandomStringUtils.random() does not strictly validate start and end (#1682). Thanks to Zhongxin Yan, Gary Gregory.
*            Fix CharSequenceUtils.lastIndexOf for supplementary code points #1684. Thanks to alhudz, Gary Gregory.
*            Range.readObject() does not re-assert the comparator/ordering invariant (#1686). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            Fraction.readObject() does not re-assert denominator != 0 (#1688). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            FastDateParser.readObject(ObjectInputStream) now validates the same (#1692). Thanks to Omkhar Arasaratnam, Gary Gregory.
*            Fix StringUtils.indexOfAny() matching an unpaired trailing high surrogate (#1687). Thanks to alhudz, Gary Gregory.
*            Fix LookupTranslator code point consumption for supplementary keys (#1691). Thanks to alhudz, Gary Gregory.
*            Re-assert CharRange start <= end invariant in readObject (#1693). Thanks to alhudz, Gary Gregory.
*            FluentBitSet.readObject(ObjectInputStream) should validate constructor invariants (#1694). Thanks to Gary Gregory.
*            EventListenerSupport.readObject(ObjectInputStream) should validate constructor invariants (#1695). Thanks to Gary Gregory.
*            Correct JavaDoc in Strings.java concerning case-sensitivity (#1696). Thanks to mfg92.
*            Fix case-insensitive Strings.replace() dropping length-changing matches (#1697). Thanks to alhudz, Gary Gregory.
*            Fix int overflow in StringUtils.midString() and StrBuilder.midString() length handling (#1699). Thanks to alhudz.
*            Throw IllegalArgumentException for trailing whitespace in ExtendedMessageFormat argument index (#1701). Thanks to Gary Gregory, Javid Khan.
*            Reject doubled leading sign in NumberUtils.createBigInteger (#1702). Thanks to alhudz, Gary Gregory.
*            Fix RandomStringUtils.random() false rejection of letters and digits (#1703). Thanks to alhudz, Gary Gregory.
*            Fix substringAfter(Last) for supplementary code points (#1707). Thanks to alhudz, Gary Gregory.
*            Strip L suffix for oversized hex literals in createNumber (#1712). Thanks to alhudz, Gary Gregory.
*            Fix spurious overflow in Fraction.add/subtract for coprime denominators (#1709). Thanks to alhudz, Gary Gregory.
*            Drop trailing empty token from splitByWholeSeparator (#1710). Thanks to alhudz, Gary Gregory.
*            Fix indexOfDifference splitting a surrogate pair (#1713). Thanks to alhudz, Gary Gregory.
*            Fix int mask sign extension in BitField long methods (#1711). Thanks to alhudz, Gary Gregory.
*            Account for duplicate values in ObjectUtils.median() (#1715). Thanks to alhudz, Gary Gregory.
*            Fix silent int overflow in Fraction.getFraction(double) (#1717). Thanks to alhudz, Gary Gregory.
*            Find NaN in ArrayUtils.lastIndexOf for double and float arrays (#1718). Thanks to alhudz, Gary Gregory.
*            Reject sign characters in UnicodeUnescaper hex values (#1721). Thanks to alhudz, Gary Gregory.
*            Keep abbreviate and truncate off surrogate pair boundaries (#1719). Thanks to alhudz, Gary Gregory.
*            Keep initials from splitting a supplementary code point (#1722). Thanks to alhudz, Gary Gregory.
*            Fix int overflow in DurationFormatUtils.formatPeriod (#1720). Thanks to alhudz, Gary Gregory.
*            Fix CsvUnescaper bounds error on a single quote field (#1723). Thanks to alhudz, Gary Gregory.
* LANG-1824: Fix Strings.replace overflow on large replacements (#1716). Thanks to Dhruv Aggarwal, Gary Gregory.
*            Classify supplementary code points in StringUtils is* predicates (#1724). Thanks to alhudz, Gary Gregory.
*            Emit surrogate pair for supplementary code points in UnicodeEscaper (#1726). Thanks to alhudz, Gary Gregory.
*            Fix MethodUtils.getMatchingMethod false ambiguity on boxed arguments (#1727). Thanks to alhudz, Gary Gregory.
*            Fold supplementary code points in CharSequenceUtils.regionMatches (#1725). Thanks to alhudz, Gary Gregory.
*            Fix WordUtils.containsAllWords missing words across line breaks (#1732). Thanks to alhudz, Gary Gregory.
*            Handle supplementary code points in WordUtils case methods (#1728). Thanks to alhudz, Gary Gregory.
*            Fix StringUtils.getDigits dropping supplementary digits (#1729). Thanks to alhudz, Gary Gregory.
*            Keep StrBuilder.reverse from splitting surrogate pairs (#1730). Thanks to alhudz, Gary Gregory.
*            Fix NumberUtils min/max varargs dropping the sign of zero (#1733). Thanks to alhudz, Gary Gregory.
*            Handle supplementary code points in StringUtils.splitByCharacterType() (#1734). Thanks to alhudz, Gary Gregory.
* LANG-1828: Fix OOM in StringUtils.leftPad/rightPad when size is Integer.MIN_VALUE (#1736). Thanks to Dhruv Aggarwal, Gary Gregory.
*            Fix Strings.CI.indexOf() returning out-of-range index for empty search (#1737). Thanks to alhudz, Gary Gregory.
* LANG-1827: Support escaped single quotes ('') in DurationFormatUtils format patterns (#1700). Thanks to Sarankumar Baskar, Gary Gregory.
*            Keep DurationFormatUtils.lexx() from merging repeated fields split by a literal (#1738). Thanks to alhudz, Gary Gregory.
*            Reject hex letters in NumericEntityUnescaper decimal scan (#1739). Thanks to alhudz, Gary Gregory.
*            Keep FastDateParser numeric parse from throwing on int overflow (#1741). Thanks to alhudz, Gary Gregory.
*            Keep FastDateParser.parse error message intact for Japanese imperial locale (#1743). Thanks to alhudz, Gary Gregory.
*            Keep ExtendedMessageFormat from rejecting a quoted format style (#1744). Thanks to alhudz, Gary Gregory.
*            Match String case folding in StrBuilder.equalsIgnoreCase (#1745). Thanks to alhudz, Gary Gregory.
*            Fix FieldUtils.getField false ambiguity on inherited interface field (#1748). Thanks to alhudz, Gary Gregory.
*            Skip Chuvash locale parser tests on Java 27 (#1746). Thanks to Sarankumar Baskar, Gary Gregory.
*            Fix ArrayUtils.reverse range underflow on Integer.MIN_VALUE end (#1750). Thanks to alhudz, Gary Gregory.
*            Fix sign extension in BitField.getValue for top-bit fields (#1749). Thanks to alhudz, Gary Gregory.
*            Fix int overflow in FluentBitSet.setInclusive at Integer.MAX_VALUE (#1751). Thanks to alhudz, Gary Gregory.
*            Add messages when throwing NullPointerException. Thanks to Gary Gregory.
*            [Javadoc] Fix Failable class comment to clarify comparison of lambda versions (#1752). Thanks to Konrad Windszus.
* LANG-1829: Add tests for DateUtils.truncatedCompareTo and truncatedEquals (#1753). Thanks to Maksym Korshun.
* LANG-1830: Avoid repeated regex compilation in ClassUtils.toCleanName() (#1754). Thanks to Maksym Korshun.
*            Add missing test for ObjectUtils.isEmpty(Object) and wait(Object, Duration) (#1755, #1756). Thanks to Maksym Korshun, Gary Gregory.
*            Fix negative week year formatting in FastDatePrinter (#1762). Thanks to alhudz, Gary Gregory.
*            Keep abbreviateMiddle off surrogate pair boundaries (#1758). Thanks to kdelay, Gary Gregory.
* LANG-1815: Fix AnnotationUtils.equals for package-private annotations (#1760). Thanks to Maksym Korshun, Gary Gregory.
*            Fix two Javadoc errors in StringUtils (#1763). Thanks to hunghhdev.
*            Reject non-ASCII hex characters in Conversion.hexDigitToInt (#1767). Thanks to alhuda, Gary Gregory.
*            Fix the overflow bound direction in Instants.toMillisSince(Instant) (#1766). Thanks to renechoi, Gary Gregory.
*            Fix spurious overflow in Fraction.multiplyBy for unreduced operands (#1769). Thanks to alhuda, Gary Gregory.
*            Fix low surrogate false match in StringUtils containsAny/containsNone/indexOfAny (#1771). Thanks to alhuda, Gary Gregory.
*            Keep StringUtils.chop from splitting a trailing surrogate pair (#1770). Thanks to alhuda, Gary Gregory.
*            Keep StringUtils stripStart and stripEnd off surrogate pair boundaries (#1773). Thanks to alhuda, Gary Gregory.
*            Fix the month/day example in DurationFormatUtils.formatPeriod Javadoc (#1772). Thanks to codeAnqiang-ma, Gary Gregory.
*            Fix typos in Javadoc and example comments (#1774). Thanks to gaurav kumar pandey, Gary Gregory.
*            Fix CharRange.contains(CharRange) for negated argument ranges (#1775). Thanks to alhuda, Gary Gregory.
*            Fix SpotBugs USO_UNSAFE_METHOD_SYNCHRONIZATION in CharSet. Thanks to Gary Gregory.
*            Keep StopWatch.formatSplitTime from clamping splits to int millis (#1777). Thanks to alhuda, Gary Gregory.
*            Keep StringUtils left, right, mid, and overlay off surrogate pair boundaries (#1776). Thanks to gaurav kumar pandey, Gary Gregory.
*            Align ReflectionDiffBuilder with AbstractReflection and add cycle detection to prevent StackOverflowError on cyclic object graphs. Thanks to Gaurav Pandey, Gary Gregory.
*            Fix DurationFormatUtils.formatPeriod() calculation when pattern omits 'M' (#1780). Thanks to gaurav kumar pandey, Gary Gregory.
*            FastDateParser parses 'Y' (week year) as plain calendar year; asymmetric with FastDatePrinter and with SimpleDateFormat; boundary dates shift by a full year, silently (f002). Thanks to Gary Gregory.
*            UnicodeUnescaper.unescapeJava/EcmaScript/Json: malformed \u sequences throw undeclared IllegalArgumentException, AND non-ASCII digit spellings of \u escapes are silently accepted; both arms of one missing ASCII-hex prescan (f004). Thanks to Gary Gregory.
*            StringUtils.replaceEachRepeatedly derives its recursion budget from the input itself; the documented StackOverflowError protection fails on large tables, and expanding rules amplify text 64x even at the default TTL (f005). Thanks to Gary Gregory.
*            EventUtils.EventBindingInvocationHandler.invoke() dispatches Object.hashCode/equals/toString into the bound business method (empty-eventTypes default), or returns null -> NPE from hash collections (non-empty) (f006). Thanks to Gary Gregory.
*            LocaleUtils static caches no longer grows on invalid input to LocaleUtils.countriesByLanguage(String) (f007). Thanks to Gary Gregory.
*            LocaleUtils static caches no longer grows on invalid input to LocaleUtils.countriesByLanguage(String) (f007). Thanks to Gary Gregory.
*            ExtendedMessageFormat.applyPattern() is quadratic: full pattern.toCharArray() per token (f008). Thanks to Gary Gregory.
*            WordUtils.wrap(wrapLongWords=false, the 2-arg default) copies the entire remaining string every iteration. (f009). Thanks to Gary Gregory.
*            FastDateParser.parse throws undeclared IllegalArgumentException, NullPointerException, and IllegalStateException on crafted date strings (f010). Thanks to Gary Gregory.
*            Memoizer: default caches the first failure forever, has no size bound or eviction, and runs the user computation inside the ConcurrentHashMap bin lock (blocking unrelated keys, deadlocking reentrant use) (f011). Thanks to Gary Gregory.
*            StringEscapeUtils.escapeEcmaScript() misses backtick/template-literal (`, ${) and inline-script parser-state sequences (<!--, <script) - claim 'Deals correctly with quotes' is falsified by ES6 (f012). Thanks to Gary Gregory.
*            StrSubstitutor (deprecated) recursive expansion has a cycle check but no fan-out, depth, or size bound (f013). Thanks to Gary Gregory.
*            DurationFormatUtils.formatPeriod walks the calendar one year per iteration, Long.MAX_VALUE endMillis forces ~292 million Calendar round trips on one thread (f014). Thanks to Gary Gregory.
*            JavaVersion.get() throws NumberFormatException where javadoc promises null (f015). Thanks to Gary Gregory.
*            Match Javadoc to code in SystemProperties.getProperty() and SystemUtils.getEnvironmentVariable() and update inline comments (f016). Thanks to Gary Gregory.
*            Fix LockingVisitors Javadoc to match code (f017). Thanks to Gary Gregory.
*            DoubleRange/Range accept NaN endpoints, silently producing a half-unbounded range, contains()/fit() fail open for every value above the minimum (f018). Thanks to Gary Gregory.
*            BitField long-mask fields silently mis-answer int/short/byte accessors: shifts masked mod 32, and sign extension makes above-bit-31 flags read as set on any negative holder (f019). Thanks to Gary Gregory.
*            ClassUtils.getClass() name normalization (whitespace stripping + dot-to-dollar rewriting) defeats host-side class-name string checks (f020). Thanks to Gary Gregory.
*            Fraction.getFraction(String) throws undeclared ArithmeticException on crafted numeric strings ('9999999999.5', '1/0', mixed-number overflow) (f021). Thanks to Gary Gregory.
*            StringEscapeUtils.escapeHtml4/3 apostrophe gap: single-quoted and unquoted HTML attribute contexts are trivially breakable, and the javadoc discloses the gap only as an HTML4 entity-legality footnote (f022). Thanks to Gary Gregory.
*            ArrayUtils.addAll/insert length arithmetic overflows (undeclared NegativeArraySizeException) while sibling concat is overflow-checked (f023). Thanks to Gary Gregory.
*            FormattableUtils.append pads right-justified output with insert(0) per char; O(width^2); '%500000s' costs ~1.25e11 char moves (f024). Thanks to Gary Gregory.
*            Attacker-controlled exception message forges frames in getRootCauseStackTrace output AND suppresses all real frames, beyond cosmetic log spoofing (f025). Thanks to Gary Gregory.
*            StrBuilder.indexOf materializes the whole builder as a String per call; deleteAll/replaceAll multiply it into ~750 GB churn on a 1 MB builder (f026). Thanks to Gary Gregory.
*            ThresholdCircuitBreaker accepts negative increments and overflows its accumulator, silently keeping the breaker closed (f027). Thanks to Gary Gregory.
*            ExceptionUtils.getThrowableList() cycle check is O(n^2) over deep cause chains; all chain-walking consumers inherit it (f031). Thanks to Gary Gregory.
*            Reflection builders' cycle registry unregisters per-visit: cycle-SAFE but DAG-exponential, a 40-level reference diamond drives ~2^40 traversals and unbounded output (f032). Thanks to Gary Gregory.
*            FastDateFormat static caches grow without bound per distinct pattern/zone/locale, untrusted patterns pin several KB each, forever (f033). Thanks to Gary Gregory.
*            Fix Fraction.add and subtract for operands not in lowest terms (#1784). Thanks to Jeff Lenamon, Gary Gregory.
*            Fix MethodUtils.invokeMethod on instances of non-public classes (#1783). Thanks to Jeff Lenamon, Gary Gregory.
*            Fraction.add and subtract return the reduced form when an operand is zero (#1787). Thanks to Jeff Lenamon, Gary Gregory.
*            Return null for out-of-range offset in FastTimeZone.getGmtTimeZone (#1788). Thanks to alhuda, Gary Gregory.
*            Fix TypeUtils.toString() recursion and bound handling on recursive generic types (#1789). Thanks to gaurav kumar pandey, Gary Gregory.
* LANG-1834: Fix Fraction reduction for Integer.MIN_VALUE (#1794). Thanks to ????, makarandhinge, Gary Gregory.
*            Defensively clone the TimeZone in FastDatePrinter and FastDateParser (#1795). Thanks to alhuda, Gary Gregory.
*            Defensively clone time zones used as FastDateFormat cache keys to prevent caller mutations from returning formatters with stale time zone rules. Thanks to Gary Gregory.
*            Fix ConstructorUtils.getMatchingAccessibleConstructor on non-public classes (#1793). Thanks to gaurav kumar pandey, Gary Gregory.
*            Fix NumberUtils.createNumber() and isCreatable() for positive Long literals with explicit '+' sign (#1796). Thanks to gaurav kumar pandey, Gary Gregory.
*            Fix StrBuilder.lastIndexOf(String) start index for an empty search (#1759). Thanks to alhudz, Gary Gregory.
*            Fix int overflow in Conversion count and position bounds guards (#1779). Thanks to alhudz, Gary Gregory.
*            Preserve serialization compatibility with 3.20.0 for Range, IntegerRange, LongRange, and DoubleRange by retaining Range serialVersionUID 1L.
             Streams written by 3.21.0 RC1 with UID 2L require reading with RC1 and exporting endpoint and comparator values before rebuilding ranges with this release.

Changes:
*            Bump org.apache.commons:commons-parent from 92 to 105 #1498. Thanks to Gary Gregory, Dependabot.
*            [test] Bump org.apache.commons:commons-text from 1.14.0 to 1.15.0. Thanks to Gary Gregory.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.20.0 Release Notes
----------------------------------------

The Apache Commons Lang team is pleased to announce the release of Apache Commons Lang 3.20.0.

Commons Lang is a set of utility functions and reusable components that should be useful in any Java environment.

Starting with Commons Lang 3.9, we target Java 8, using those features.

For advice on upgrading from 2.x to 3.x, see:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

The code is tested using the latest revision of the JDK for supported
LTS releases: 8, 11, 17, 21 and 25 currently.
See https://github.com/apache/commons-lang/blob/master/.github/workflows/maven.yml

Please ensure your build environment is up-to-date and kindly report any build issues.

This is a feature and maintenance release. Java 8 or later is required.

Changes in this version include:

New features:
*            Add SystemProperties.getPath(String, Supplier<Path>). Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_25. Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_26. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_25. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_26. Thanks to Gary Gregory.
*            Add MutablePair.ofNonNull(Map.Entry). Thanks to jack5505, Gary Gregory.
*            Add TimedSemaphore.builder(), Builder, and deprecate constructors. Thanks to Gary Gregory.
* LANG-1504: Adding labels and history to split StopWatch #1473. Thanks to Edwin Delgado H, Gary Gregory.

Fixed Bugs:
*            Optimize ObjectToStringComparator.compare() method #1449. Thanks to mayuming, Gary Gregory.
*            [javadoc] Improve StringUtils Javadoc #1450. Thanks to Marcono1234, Gary Gregory.
*            Fix internal inverted logic in private isEnum() method and correct its usage in getFirstEnum() #1454. Thanks to mayuming, Gary Gregory.
*            Use accessors in ToStringStyle so subclasses can effectively override them. Thanks to William Degrange, Gary Gregory, Rob Spoor.
*            `LocaleUtils.toLocale(String)` for a 2 letter country code now returns a value instead of throwing an `IllegalArgumentException`. Thanks to jack5505, Gary Gregory.
*            Fix typo in StringUtils.trunctate() IllegalArgumentException message and test assertion messages. Thanks to mayuming, Gary Gregory.
*            Fix test fixture in ReflectionDiffBuilderTest.testTransientFieldDifference() #1464. Thanks to mayuming, Gary Gregory.
* LANG-1789: NullPointerException when generating NoSuchMethodException in MethodUtils. Thanks to Hylke van der Schaaf, Gary Gregory.
* LANG-1786: Map deprecated TimeZone short IDs and avoid JRE WARNINGs to the console #1483. Thanks to Daniel Migowski, Gary Gregory, Lenny Primak.
* LANG-1792: TypeUtils.toString() skips angle brackets for Class type. Thanks to Mykhailo Hryb, Gary Gregory.
*            Mention JDK 25 LTS as a tested version in the release notes #1485. Thanks to Sebastian Peters, Gary Gregory.

Changes:
*            Bump org.apache.commons:commons-parent from 88 to 92 #1472, #1484. Thanks to Gary Gregory, Dependabot.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.20.0 Release Notes
----------------------------------------

The Apache Commons Lang team is pleased to announce the release of Apache Commons Lang 3.20.0.

Commons Lang is a set of utility functions and reusable components that should be useful in any Java environment.

Starting with Commons Lang 3.9, we target Java 8, using those features.

For advice on upgrading from 2.x to 3.x, see:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

The code is tested using the latest revision of the JDK for supported
LTS releases: 8, 11, 17 and 21 currently.
See https://github.com/apache/commons-lang/blob/master/.github/workflows/maven.yml

Please ensure your build environment is up-to-date and kindly report any build issues.

This is a feature and maintenance release. Java 8 or later is required.

Changes in this version include:

New features:
*            Add SystemProperties.getPath(String, Supplier<Path>). Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_25. Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_26. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_25. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_26. Thanks to Gary Gregory.
*            Add MutablePair.ofNonNull(Map.Entry). Thanks to jack5505, Gary Gregory.
*            Add TimedSemaphore.builder(), Builder, and deprecate constructors. Thanks to Gary Gregory.
* LANG-1504: Adding labels and history to split StopWatch #1473. Thanks to Edwin Delgado H, Gary Gregory.

Fixed Bugs:
*            Optimize ObjectToStringComparator.compare() method #1449. Thanks to mayuming, Gary Gregory.
*            [javadoc] Improve StringUtils Javadoc #1450. Thanks to Marcono1234, Gary Gregory.
*            Fix internal inverted logic in private isEnum() method and correct its usage in getFirstEnum() #1454. Thanks to mayuming, Gary Gregory.
*            Use accessors in ToStringStyle so subclasses can effectively override them. Thanks to William Degrange, Gary Gregory, Rob Spoor.
*            `LocaleUtils.toLocale(String)` for a 2 letter country code now returns a value instead of throwing an `IllegalArgumentException`. Thanks to jack5505, Gary Gregory.
*            Fix typo in StringUtils.trunctate() IllegalArgumentException message and test assertion messages. Thanks to mayuming, Gary Gregory.
*            Fix test fixture in ReflectionDiffBuilderTest.testTransientFieldDifference() #1464. Thanks to mayuming, Gary Gregory.
* LANG-1789: NullPointerException when generating NoSuchMethodException in MethodUtils. Thanks to Hylke van der Schaaf, Gary Gregory.
* LANG-1786: Map deprecated TimeZone short IDs and avoid JRE WARNINGs to the console #1483. Thanks to Daniel Migowski, Gary Gregory, Lenny Primak.

Changes:
*            Bump org.apache.commons:commons-parent from 88 to 92 #1472, #1484. Thanks to Gary Gregory, Dependabot.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.19.0 Release Notes
----------------------------------------

The Apache Commons Lang team is pleased to announce the release of Apache Commons Lang 3.19.0.

Commons Lang is a set of utility functions and reusable components that should be useful in any Java environment.

Starting with Commons Lang 3.9, we target Java 8, using those features.

For advice on upgrading from 2.x to 3.x, see:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

The code is tested using the latest revision of the JDK for supported
LTS releases: 8, 11, 17 and 21 currently.
See https://github.com/apache/commons-lang/blob/master/.github/workflows/maven.yml

Please ensure your build environment is up-to-date and kindly report any build issues.

This is a feature and maintenance release. Java 8 or later is required.

Changes in this version include:

New features:
*            Add ArrayUtils.SOFT_MAX_ARRAY_LENGTH. Thanks to Gary Gregory.
*            Add SystemUtils.IS_OS_NETWARE. Thanks to Gary Gregory.
*            Add MethodUtils.getAccessibleMethod(Class, Method). Thanks to Gary Gregory.
*            Add documentation to site for CVE-2025-48924 ClassUtils.getClass(...) can throw a StackOverflowError on very long inputs. Thanks to Gary Gregory.
*            Add StringUtils.indexOfAny(CharSequence, int, char...). Thanks to Gary Gregory.
*            Add ConcurrentException.ConcurrentException(String). Thanks to Gary Gregory.
*            Add DateUtils.toLocalDateTime(Date[, TimeZone]) #1385. Thanks to Finger, Gary Gregory, Piotr P. Karwasz.
*            Add DateUtils.toOffsetDateTime(Date[, TimeZone]). Thanks to Gary Gregory.
*            Add DateUtils.toZonedDateTime(Date[, TimeZone]). Thanks to Gary Gregory.
*            Add ByteConsumer. Thanks to Gary Gregory.
*            Add ByteSupplier. Thanks to Gary Gregory.
*            Add FailableByteConsumer. Thanks to Gary Gregory.
*            Add FailableByteSupplier. Thanks to Gary Gregory.
* LANG-1784: Add Functions methods for null-safe mapping and chaining #1435. Thanks to Rich Dougherty, Gary Gregory.
* LANG-1784: Add Failable methods for null-safe mapping and chaining #1435. Thanks to Rich Dougherty, Gary Gregory.
*            Add DoubleRange.fit(double). Thanks to Gary Gregory.
*            Add IntegerRange.fit(int). Thanks to Gary Gregory.
*            Add LongRange.fit(long). Thanks to Gary Gregory.
*            Add DurationUtils.get(String, TemporalUnit, long). Thanks to Gary Gregory.
*            Add DurationUtils.getMillis(String, long). Thanks to Gary Gregory.
*            Add DurationUtils.getSeconds(String, long). Thanks to Gary Gregory.
*            Add SystemProperties.getBoolean(Class, String, boolean). Thanks to Gary Gregory.
*            Add SystemProperties.getInt(Class, String, int). Thanks to Gary Gregory.
*            Add SystemProperties.getLong(Class, String, long). Thanks to Gary Gregory.

Fixed Bugs:
* LANG-1778: MethodUtils.getMatchingMethod() doesn't respect the hierarchy of methods #1414. Thanks to wuwu2000.
*            MethodUtils.getMethodObject(Class<?>, String, Class<?>...) now returns null instead of throwing a NullPointerException, as it does for other exception types. Thanks to Gary Gregory.
*            Reduce spurious failures in ArrayUtilsTest methods that test ArrayUtils.shuffle() methods. Thanks to Gary Gregory.
*            MethodUtils cannot find or invoke a public method on a public class implemented in its package-private superclass. Thanks to Gary Gregory.
*            AtomicSafeInitializer.get() can spin internally if the FailableSupplier given to AbstractConcurrentInitializer.AbstractBuilder.setInitializer(FailableSupplier) throws a RuntimeException. Thanks to Stanislav Fort, Gary Gregory.
* LANG-1783: WordUtils.containsAllWords?() may throw PatternSyntaxException. Thanks to Arnout Engelen, Stanislav Fort, Gary Gregory.
* LANG-1782: MethodUtils cannot find or invoke vararg methods without providing vararg types or values #1427. Thanks to Joe Ferner, Gary Gregory.
*            MethodUtils cannot find or invoke vararg methods of interface types. Thanks to Joe Ferner, Gary Gregory.
*            MethodUtils cannot find or invoke vararg methods when widening primitive types following the JLS 5.1.2. Widening Primitive Conversion. Thanks to Joe Ferner, Gary Gregory.
* LANG-1597: Invocation fails because matching varargs method found but then discarded. Thanks to Richard Eckart de Castilho, Gary Gregory.
*            Don't check accessibility twice in MemberUtils.setAccessibleWorkaround(T). Thanks to Gary Gregory.
* LANG-1774: Improve handling of ClassUtils.getShortCanonicalName() for invalid input #1437. Thanks to Zhongxin Yan, Madhur Lathi, Yudan Liu, Gary Gregory.
* LANG-1720: Improve Javadocs for Conversion. Thanks to Sheung Chi Chan, Arthur Chan, Gary Gregory, Elliotte Rusty Harold.
*            Fix CalendarUtils.toLocalDate() Javadoc return type description #1440. Thanks to mayuming.
*            Fix the method name in Javadoc examples for CharUtils.isHex() #1444. Thanks to mayuming.
*            Deprecate NumberUtils.compare(byte, byte) in favor of Byte.compare(byte, byte). Thanks to Gary Gregory.
*            Deprecate NumberUtils.compare(int, int) in favor of Integer.compare(int, int). Thanks to Gary Gregory.
*            Deprecate NumberUtils.compare(long, long) in favor of Long.compare(long, long). Thanks to Gary Gregory.
*            Deprecate NumberUtils.compare(short, short) in favor of Short.compare(short, short). Thanks to Gary Gregory.
*            Deprecate obsolete system property constant SystemProperties.AWT_TOOLKIT. Thanks to Gary Gregory.
*            Deprecate obsolete system property constant SystemProperties.JAVA_AWT_FONTS. Thanks to Gary Gregory.
*            Deprecate obsolete system property constant SystemProperties.JAVA_AWT_GRAPHICSENV. Thanks to Gary Gregory.
*            Deprecate obsolete system property constant SystemProperties.JAVA_AWT_HEADLESS. Thanks to Gary Gregory.
*            Deprecate obsolete system property constant SystemProperties.JAVA_AWT_PRINTERJOB. Thanks to Gary Gregory.
*            Deprecate obsolete system property constant SystemProperties.JAVA_COMPILER. Thanks to Gary Gregory.
*            Deprecate obsolete system property constant SystemProperties.JAVA_ENDORSED_DIRS. Thanks to Gary Gregory.
*            Deprecate obsolete system property constant SystemProperties.JAVA_EXT_DIRS. Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemProperties.getAwtToolkit() Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemProperties.getJavaAwtFonts() Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemProperties.getJavaAwtGraphicsenv() Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemProperties.getJavaAwtHeadless() Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemProperties.getJavaAwtPrinterjob() Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemProperties.getJavaCompiler() Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemProperties.getJavaEndorsedDirs() Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemProperties.getJavaExtDirs() Thanks to Gary Gregory.
*            Deprecate method for obsolete system property constant SystemUtils.isJavaAwtHeadless() Thanks to Gary Gregory.
*            Deprecate constants for obsolete system property SystemUtils.JAVA_AWT_FONTS. Thanks to Gary Gregory.
*            Deprecate constants for obsolete system property SystemUtils.JAVA_AWT_GRAPHICSENV. Thanks to Gary Gregory.
*            Deprecate constants for obsolete system property SystemUtils.JAVA_AWT_HEADLESS. Thanks to Gary Gregory.
*            Deprecate constants for obsolete system property SystemUtils.JAVA_AWT_PRINTERJOB. Thanks to Gary Gregory.
*            Deprecate constants for obsolete system property SystemUtils.JAVA_COMPILER. Thanks to Gary Gregory.
*            Deprecate constants for obsolete system property SystemUtils.JAVA_ENDORSED_DIRS. Thanks to Gary Gregory.
*            Deprecate constants for obsolete system property SystemUtils.JAVA_EXT_DIRS. Thanks to Gary Gregory.
*            [javadoc] General improvements. Thanks to Gary Gregory.
*            [javadoc] Fix thrown exception documentation for MethodUtils.getMethodObject(Class<?>, String, Class<?>...). Thanks to Gary Gregory.
*            [javadoc] Strings::equalsAny: CI doc string should show it's insensitive #1416. Thanks to Scott Parish.
*            [javadoc] General Javadoc improvements. Thanks to Gary Gregory.
* LANG-1780: [javadoc] Fix Strings Javadoc #1419. Thanks to tza.
*            [javadoc] Fix typo in Javadoc of Strings instances #1406. Thanks to Sebastian Steiner.
*            [javadoc] Fix Javadocs in ClassUtils #1410. Thanks to Hassan A Hashim.
*            [javadoc] Fix @deprecated link for StringUtils#startsWithAny #1424. Thanks to mfg92.
*            Replace old feather logotype with new oak logotype. Thanks to Gary Gregory.

Changes:
*            [test] Bump org.apache.commons:commons-text from 1.13.1 to 1.14.0. Thanks to Gary Gregory.
*            Bump org.apache.commons:commons-parent from 85 to 88. Thanks to Gary Gregory.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.18.0 Release Notes
----------------------------------------

The Apache Commons Lang team is pleased to announce the release of Apache Commons Lang 3.18.0.

Commons Lang is a set of utility functions and reusable components that should be useful in any Java environment.

Starting with Commons Lang 3.9, we target Java 8, using those features.

For advice on upgrading from 2.x to 3.x, see:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

The code is tested using the latest revision of the JDK for supported
LTS releases: 8, 11, 17 and 21 currently.
See https://github.com/apache/commons-lang/blob/master/.github/workflows/maven.yml

Please ensure your build environment is up-to-date and kindly report any build issues.

This is a feature and maintenance release. Java 8 or later is required.

Changes in this version include:

New features:
*            Add Strings and refactor StringUtils. Thanks to Gary Gregory.
* LANG-1747: Add StopWatch.run([Failable]Runnable) and get([Failable]Supplier). Thanks to Oliver B. Fischer, Gary Gregory.
*            Add JavaVersion.JAVA_23. Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_24. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_23. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_24. Thanks to Gary Gregory.
*            Add IntegerRange.toIntStream(). Thanks to Gary Gregory.
*            Add LongRange.toLongStream(). Thanks to Gary Gregory.
*            Add IntStrams.of(int...). Thanks to Gary Gregory.
*            Add ArrayUtils.containsAny(int[], int...). Thanks to Gary Gregory.
*            Add CalendarUtils.toLocalDate() #725. Thanks to asgh, Gary Gregory.
*            Add SystemUtils.IS_OS_MAC_OSX_SEQUOIA. Thanks to Gary Gregory.
*            Add BasicThreadFactory.builder() and deprecate BasicThreadFactory.Builder(). Thanks to Gary Gregory.
*            Add BasicThreadFactory.daemon(). Thanks to Gary Gregory.
*            Add ArrayUtils.startsWith. Thanks to Gary Gregory.
*            Add Predicates. Thanks to Gary Gregory.
*            Add RegExUtils methods typed to CharSequence input and deprecate old versions typed to String. Thanks to Gary Gregory.
*            Add IterableStringTokenizer. Thanks to Gary Gregory.
*            Add FailableIntToFloatFunction. Thanks to Gary Gregory.
*            Add Validate.isTrue(boolean, Supplier<String>). Thanks to Gary Gregory.
*            Add EnumUtils.getFirstEnum(Class<E>, int, ToIntFunction<E>, E). Thanks to Gary Gregory.
*            Add FailableToBooleanFunction. Thanks to Gary Gregory.
*            Add the @FunctionalInterface annotation to org.apache.commons.lang3.concurrent.Computable. Thanks to Gary Gregory.
*            Add SystemUtils.getJavaIoTmpDirPath(). Thanks to Gary Gregory.
*            Add SystemUtils.getJavaHomePath(). Thanks to Gary Gregory.
*            Add SystemUtils.getUserDirPath(). Thanks to Gary Gregory.
*            Add SystemUtils.getUserHomePath(). Thanks to Gary Gregory.
*            Add ArrayFill.fill(T[], FailableIntFunction)). Thanks to Gary Gregory.
*            Add SystemProperties.JAVA_SECURITY_DEBUG. Thanks to Gary Gregory.
*            Add SystemProperties.JAVA_SECURITY_KERBEROS_CONF. Thanks to Gary Gregory.
*            Add SystemProperties.JAVA_SECURITY_KERBEROS_KDC. Thanks to Gary Gregory.
*            Add SystemProperties.JAVA_SECURITY_KERBEROS_REAL. Thanks to Gary Gregory.
*            Add ArrayFill.fill(boolean[], boolean) #1386. Thanks to kommalapatiraviteja.
*            Add ObjectUtils.getIfNull(Object, Object) and deprecate defaultIfNull(Object, Object). Thanks to Pankraz76, Gary Gregory.
*            org.apache.commons.lang3.mutable.Mutable now extends Supplier. Thanks to Gary Gregory.
*            Add org.apache.commons.lang3.CharUtils.isHex(char). Thanks to Gary Gregory.
*            Add org.apache.commons.lang3.CharUtils.isOctal(char). Thanks to Gary Gregory.
*            Add org.apache.commons.lang3.concurrent.locks.LockingVisitors.reentrantLockVisitor(Object). Thanks to Gary Gregory.
*            Add org.apache.commons.lang3.concurrent.locks.LockingVisitors.create(Object, ReentrantLock). Thanks to Gary Gregory.
*            Add org.apache.commons.lang3.concurrent.locks.LockingVisitors.ReentrantLockVisitor. Thanks to Gary Gregory.
*            Add builders for LockingVisitors implementations. Thanks to Gary Gregory.
*            Add EnumSet.stream(Class). Thanks to Gary Gregory.
*            Add org.apache.commons.lang3.SystemProperties.isPropertySet(String). Thanks to Gary Gregory.

Fixed Bugs:
*            Fix flaky FileUtilsWaitForTest.testWaitForNegativeDuration(). Thanks to Gary Gregory.
*            Pick up exec-maven-plugin version from parent POM. Thanks to Gary Gregory.
*            Speed up and sanitize StopWatchTest. Thanks to Gary Gregory.
*            Fix handling of non-ASCII letters and numbers in RandomStringUtils #1273. Thanks to Fabrice Benhamouda.
*            Rewrite ClassUtils.getClass(...) without recursion to avoid StackOverflowError on very long inputs.
             OSS-Fuzz Issue 42522972: apache-commons-text:StringSubstitutorInterpolatorFuzzer: Security exception in org.apache.commons.lang3.ClassUtils.getClass. Thanks to OSS-Fuzz, Gary Gregory.
*            Remove trailing whitespace in StopWatch exception messages. Thanks to Gary Gregory.
* LANG-1754: Use getAllSuperclassesAndInterfaces() in getMatchingMethod() #1289. Thanks to vhbcm.
*            Add details to the ArrayFill Javadoc. Thanks to Gary Gregory.
*            Add details to the ArraySorter Javadoc. Thanks to Gary Gregory.
*            Fix broken URL to project location in Maven Central #1296. Thanks to Capt. Cutlass.
* LANG-1753: StringUtils.replaceEachRepeatedly regression in 3.11+ #1297. Thanks to Capt. Cutlass.
*            Use simplified JUnit assertion methods #1298. Thanks to Capt. Cutlass.
* LANG-1682: Javadoc and test: Use Strings.CI.startsWithAny method instead #1299. Thanks to Capt. Cutlass.
*            Fix NullPointerException in FastDateParser.TimeZoneStrategy.setCalendar(FastDateParser, Calendar, String) on Java 23. Thanks to Gary Gregory.
* LANG-1757: Fix NullPointerException in MethodUtils.getMatchingAccessibleMethod((Class, String, Class...)). Thanks to Gary Gregory.
* LANG-1698: Fix StackOverflowError in TypeUtils.typeVariableToString(TypeVariable), TypeUtils.toString(Type) on Java 17 and up. Thanks to Jan Arne Sparka, Gary Gregory.
* LANG-1511: SystemUtils is missing important documentation. Thanks to david cogen, Gary Gregory, Bruno P. Kinoshita.
*            Make Failable.run(FailableRunnable) null-safe. Thanks to Gary Gregory.
*            Make Failable.accept(*) null-safe. Thanks to Gary Gregory.
*            Improve container detection by mimicking systemd #1323. Thanks to maxxedev, Piotr P. Karwasz, Gary Gregory.
*            Make LangCollectors.collect(...) null-safe. Thanks to Gary Gregory.
*            Make LangCollectors.collect(...) null-safe. Thanks to Gary Gregory.
*            Fix names of UTF-16 surrogate character test fixture constants, see also #1326. Thanks to IBue, Gary Gregory.
*            Moditect plugin generates split package warnings. Thanks to Gary Gregory.
*            LocaleUtils.availableLocaleSet() uses predictable iteration order. Thanks to Gary Gregory.
* LANG-1759: SerializationUtils.clone(Object) throws ClassCastException when called with a Serializable lambda. Thanks to Maxim Butov, Gary Gregory.
* LANG-1759: [StringUtils::indexOfAnyBut] redesign due to inconsistent/faulty behavior regarding UTF-16 surrogates #1327. Thanks to IBue, Gary Gregory, Piotr P. Karwasz.
*            Undeprecate ObjectUtils.toString(Object). Thanks to Gary Gregory.
*            Fix Spotbugs [ERROR] Medium: The field org.apache.commons.lang3.builder.DiffBuilder$SDiff.leftSupplier is transient but isn't set by deserialization [org.apache.commons.lang3.builder.DiffBuilder$SDiff] In DiffBuilder.java SE_TRANSIENT_FIELD_NOT_RESTORED. Thanks to Gary Gregory.
*            Fix Spotbugs [ERROR] Medium: The field org.apache.commons.lang3.builder.DiffBuilder$SDiff.rightSupplier is transient but isn't set by deserialization [org.apache.commons.lang3.builder.DiffBuilder$SDiff] In DiffBuilder.java SE_TRANSIENT_FIELD_NOT_RESTORED. Thanks to Gary Gregory.
* LANG-1762: StopWatch methods should not delegate to deprecated methods. Thanks to Alonso Gonzalez, Gary Gregory.
*            Don't call TypeUtils.toString(Type) on every array item in TypeUtils.parameterize[WithOwner](Type, Class, Map, Type>) unless required. Thanks to Gary Gregory.
*            Remove -nouses directive from maven-bundle-plugin. OSGi package imports now state 'uses' definitions for package imports, this doesn't affect JPMS (from org.apache.commons:commons-parent:80). Thanks to Gary Gregory.
*            Instead of throwing a NullPointerException, ArrayUtils.toStringArray(Object[]) should return "null" for null elements like ArrayUtils.toStringArray(Object[], String) returns its valueForNullElements. Thanks to Gary Gregory.
* LANG-1764: Deprecate NumericEntityUnescaper.OPTION in favor of Apache Commons Text. Thanks to Gary Gregory.
*            Several hash collisions in Fraction class. Thanks to Gary Gregory.
* LANG-1768: MutableLong and friends should provide better parsing exceptions Javadocs. Thanks to Wang Hailong, Gary Gregory.
*            Reimplement StringUtils.toCodePoints(CharSequence) to use java.lang.CharSequence.codePoints(). Thanks to Gary Gregory.
*            Reimplement StringUtils.capitalize(String) to use java.lang.CharSequence.codePoints(). Thanks to Gary Gregory.
*            Reimplement StringUtils.uncapitalize(String) to use java.lang.CharSequence.codePoints(). Thanks to Gary Gregory.
*            org.apache.commons.lang3.ClassUtils.getCanonicalName(String) now throws an IllegalArgumentException for array dimensions greater than 255. Thanks to Gary Gregory.
*            Fix Javadoc typo and improve clarity in defaultIfBlank method #1376. Thanks to Sridhar Balijepalli, Piotr P. Karwasz.
* LANG-1773: Apache Commons Lang no longer builds on Android #1381. Thanks to Éamonn McManus, Gary Gregory.
* LANG-1772: Restrict size of cache to prevent overflow errors #1379. Thanks to James Winters, Piotr P. Karwasz, Gary Gregory.
* LANG-1772: Reimplement org.apache.commons.lang3.ClassUtils.hierarchy(Class, Interfaces) using an AtomicReference. Thanks to Gary Gregory.
*            Fix Javadoc code examples in DiffBuilder and ReflectionDiffBuilder #1400. Thanks to Ken Dombeck.
*            Fix generics in org.apache.commons.lang3.stream.Streams.toArray(Class) signature. Thanks to Gary Gregory.
* LANG-1727: EventListenerSupport doesn't document ordering of events. Thanks to Elliotte Rusty Harold, Gary Gregory.
*            Fix edge-case NullPointerException in org.apache.commons.lang3.SystemUtils.IS_OS_ANDROID. Thanks to Gary Gregory.
*            Fix edge-case NullPointerException in org.apache.commons.lang3.SystemUtils.isJavaVersionAtLeast(JavaVersion). Thanks to Gary Gregory.
*            Fix edge-case NullPointerException in org.apache.commons.lang3.SystemUtils.isJavaVersionAtMost(JavaVersion). Thanks to Gary Gregory.
*            Return the default enum if a SecurityException is caught in getEnumSystemProperty(). Thanks to Gary Gregory.
*            Fix edge-case NullPointerException in org.apache.commons.lang3.EnumUtils.getEnum(Class, String, E). Thanks to Gary Gregory.
*            org.apache.commons.lang3.EnumUtils.getFirstEnumIgnoreCase(Class, String, Function, E) now returns the given default enum on null enumClass input. Thanks to Gary Gregory.
*            org.apache.commons.lang3.EnumUtils.getEnumIgnoreCase(Class, String, E) now returns the given default enum on null enumClass input. Thanks to Gary Gregory.
*            org.apache.commons.lang3.EnumUtils.getEnumIgnoreCase(Class, String) now returns the given default enum on null enumClass input. Thanks to Gary Gregory.
*            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.equalTo(A). Thanks to Gary Gregory.
*            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.greaterThan(A). Thanks to Gary Gregory.
*            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.greaterThanOrEqualTo(A). Thanks to Gary Gregory.
*            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.lessThan(A). Thanks to Gary Gregory.
*            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.lessThanOrEqualTo(A). Thanks to Gary Gregory.
* LANG-1776: Use GitHub URL in POM for improved automation support.

Changes:
*            Bump org.apache.commons:commons-parent from 73 to 85 #1267, #1277, #1283, #1288, #1302, #1377. Thanks to Gary Gregory, Dependabot.
*            [site] Bump org.codehaus.mojo:taglist-maven-plugin from 3.1.0 to 3.2.1 #1300. Thanks to Gary Gregory, Dependabot.
*            [test] Bump org.easymock:easymock from 5.4.0 to 5.6.0 #1317, #1387. Thanks to Gary Gregory, Dependabot.
*            [test] Bump org.apache.commons:commons-text from 1.12.0 to 1.13.1 #1336. Thanks to Gary Gregory, Dependabot.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.17.0 Release Notes
----------------------------------------

The Apache Commons team is pleased to announce Apache Commons Lang Version 3.17.0.

Commons Lang is a set of utility functions and reusable components that should be useful in any Java environment.

Starting with Commons Lang 3.9, we target Java 8, using those features.

For advice on upgrading from 2.x to 3.x, see:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

The code is tested using the latest revision of the JDK for supported
LTS releases: 8, 11, 17 and 21 currently.
See https://github.com/apache/commons-lang/blob/master/.github/workflows/maven.yml

Please ensure your build environment is up-to-date and kindly report any build issues.

This is a feature and maintenance release. Java 8 or later is required.

Changes in this version include:

New features:
*            RandomUtils.secure() now uses SecureRandom() instead of SecureRandom.getInstanceStrong(). Thanks to Gary Gregory.
*            RandomStringUtils.secure() now uses SecureRandom() instead of SecureRandom.getInstanceStrong(). Thanks to Gary Gregory.
*            Remove unused exception from deprecated StringUtils.toString(byte[], String). Thanks to Gary Gregory.
*            Make RandomUtils.insecure() public. Thanks to Gary Gregory.
*            Add RandomUtils.secureStrong(). Thanks to Gary Gregory.
*            Add RandomStringUtils.secureStrong(). Thanks to Gary Gregory.
*            Add CalendarUtils.toLocalDateTime(Calendar). Thanks to Gary Gregory.
*            Add CalendarUtils.toLocalDateTime(). Thanks to Gary Gregory.
*            Add CalendarUtils.toZonedDateTime(Calendar). Thanks to Gary Gregory.
*            Add CalendarUtils.toZonedDateTime(). Thanks to Gary Gregory.
*            Add CalendarUtils.toOffsetDateTime(Calendar). Thanks to Gary Gregory.
*            Add CalendarUtils.toOffsetDateTime(). Thanks to Gary Gregory.

Fixed Bugs:
* LANG-1760: Using RandomStringUtils.insecure() still leads to using the secure() random. Thanks to Marco Hoek, Gary Gregory.
*            Deprecate static RandomUtils.next*() methods in favor or .secure() and .insecure() versions. Thanks to Gary Gregory.
*            Deprecate static RandomStringUtils.random*() methods in favor or .secure() and .insecure() versions. Thanks to Gary Gregory.

Changes:
*            Bump org.hamcrest:hamcrest from 2.2 to 3.0 #1255. Thanks to Gary Gregory, Dependabot.
*            Bump org.easymock:easymock from 5.3.0 to 5.4.0 #1256. Thanks to Gary Gregory, Dependabot.
*            Bump org.codehaus.mojo:exec-maven-plugin from 3.3.0 to 3.4.1 #1262, #1264. Thanks to Gary Gregory, Dependabot.
*            Bump org.apache.commons:commons-parent from 72 to 73 #1265. Thanks to Gary Gregory, Dependabot.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.16.0 Release Notes
----------------------------------------

The Apache Commons team is pleased to announce Apache Commons Lang Version 3.16.0.

Commons Lang is a set of utility functions and reusable components that should be useful in any Java environment.

Starting with Commons Lang 3.9, we target Java 8, using those features.

For advice on upgrading from 2.x to 3.x, see:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

The code is tested using the latest revision of the JDK for supported
LTS releases: 8, 11, 17 and 21 currently.
See https://github.com/apache/commons-lang/blob/master/.github/workflows/maven.yml

Please ensure your build environment is up-to-date and kindly report any build issues.

This is a feature and maintenance release. Java 8 or later is required.

Changes in this version include:

New features:
*            Add StopWatch.getSplitDuration() and deprecate getSplitTime(). Thanks to Gary Gregory.
*            Add StopWatch.getStartInstant() and deprecate getStartTime(). Thanks to Gary Gregory.
*            Add StopWatch.getStopInstant() and deprecate getStopTime(). Thanks to Gary Gregory.
*            Add StopWatch.getDuration() and deprecate getTime(). Thanks to Gary Gregory.
*            Add Javadoc links from StopWatch to DurationUtils #1249. Thanks to Oliver B. Fischer, Gary Gregory.
*            Add LangCollectors.collect(Collector, T...). Thanks to Gary Gregory.
*            Add RandomStringUtils.secure(). Thanks to Gary Gregory.
*            Add RandomStringUtils.insecure(). Thanks to Gary Gregory.

Fixed Bugs:
*            Reimplement StopWatch internals to use java.time. Thanks to Gary Gregory.
* LANG-1745: RandomStringUtils.random() with a negative character index should throw IllegalArgumentException. Thanks to Wang Hailong, Gary Gregory.
* LANG-1741: LocaleUtils.toLocale(String) cannot parse four segments. Thanks to Wang Hailong, Gary Gregory.
*            Use fewer intermediary strings in DefaultExceptionContext.getFormattedExceptionMessage(String). Thanks to Gary Gregory.
*            Fix Javadoc in StringUtils.splitPreserveAllTokens() #1251. Thanks to V�clav Haisman.
*            Deprecate ArraySort constructor for removal. Thanks to Gary Gregory.
*            Deprecate CharEncoding constructor for removal. Thanks to Gary Gregory.
*            Deprecate Conversion constructor for removal. Thanks to Gary Gregory.
*            Deprecate Conversion constructor for removal. Thanks to Gary Gregory.
*            Deprecate EntityArrays constructor for removal. Thanks to Gary Gregory.
*            Deprecate ObjectToStringComparator constructor for removal. Thanks to Gary Gregory.
*            Deprecate RuntimeEnvironment constructor for removal. Thanks to Gary Gregory.

Changes:
*            Bump org.apache.commons:commons-parent from 71 to 72 #1253. Thanks to Gary Gregory, Dependabot.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.15.0 Release Notes
----------------------------------------

The Apache Commons team is pleased to announce Apache Commons Lang Version 3.15.0.

Commons Lang is a set of utility functions and reusable components that should be of use in any Java environment.

Starting with Commons Lang 3.9, we target Java 8, making use of those features.

For advice on upgrading from 2.x to 3.x, see:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

The code is tested using the latest revision of the JDK for supported
LTS releases: 8, 11, 17 and 21 currently.
See https://github.com/apache/commons-lang/blob/master/.github/workflows/maven.yml

Please ensure your build environment is up-to-date and kindly report any build issues.

New features and bug fixes (Java 8 or above).

Changes in this version include:

New features:
* LANG-1724: Customize text pattern in DiffResult#toString(). Thanks to Gary Gregory, Dennis Baerten.
*            Add DiffBuilder.Builder. Thanks to Gary Gregory.
*            Add DiffBuilder.builder(). Thanks to Gary Gregory.
*            Add ReflectionDiffBuilder.Builder. Thanks to Gary Gregory.
*            Add ReflectionDiffBuilder.builder(). Thanks to Gary Gregory.
*            Add test in TypeUtilsTest #1151. Thanks to Elliotte Rusty Harold.
*            Add Streams.failableStream(T), non-varargs variant. Thanks to Gary Gregory.
*            Add Streams.nonNull(T), non-varargs variant. Thanks to Gary Gregory.
*            Add ArrayUtils.nullTo(T[], T[]). Thanks to Gary Gregory.
*            Add T ArrayUtils.arraycopy(T, int, T, int, int) fluent style. Thanks to Gary Gregory.
*            Add T ArrayUtils.arraycopy(T, int, int, int, Function) fluent style. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_22. Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_22. Thanks to Gary Gregory.
*            Add SystemProperties.getUserName(Supplier<String>). Thanks to Gary Gregory.
*            Add SystemProperties.getLineSeparator(Supplier<String>). Thanks to Gary Gregory.
*            Add SystemProperties.getJavaSpecificationVersion(Supplier<String>). Thanks to Gary Gregory.
*            Add SystemProperties constants and methods for system properties as of Java 22. Thanks to Gary Gregory.
*            Add MethodUtils.getMethodObject(Class, String, Class...). Thanks to Gary Gregory.
* LANG-1733: Add null-safe Consumers.accept() and Functions.apply() #1215. Thanks to Jongjin Bae, Gary Gregory.
*            Add SystemUtils.IS_OS_ANDROID. Thanks to Gary Gregory.
*            Add SystemUtils.IS_OS_MAC_OSX_SONOMA. Thanks to Gary Gregory.
*            Add RuntimeEnvironment.inContainer() #1241. Thanks to Gary Gregory.
*            Add AppendableJoiner and refactor string joining #1244. Thanks to Gary Gregory.

Fixed Bugs:
*            Improve Javadoc in ExceptionUtils #1136. Thanks to Mikl�s Karak�, Gary Gregory.
*            Fixed two non-deterministic tests in EnumUtilsTest.java #1131. Thanks to Saiharshith Karuneegar Ramesh, Gary Gregory.
* LANG-1721: Fix wrong number check that cause StringIndexOutOfBoundsException #1140. Thanks to Arthur Chan, Gary Gregory.
* LANG-1722: Rethrow NegativeArraySizeException as SerializationException in SerializationUtils.deserialize(InputStream) #1141. Thanks to Arthur Chan.
* LANG-1723: Throw NumberFormatException instead of IndexOutOfBoundsException in NumberUtils.getMantissa(String, int) #1145. Thanks to Arthur Chan, Gary Gregory.
*            Minor grammar fixes #1143. Thanks to Parano�d User.
* LANG-1713: ArrayUtils will return null when adding two null arrays, but undocumented. Thanks to John Hendrikx, Gary Gregory.
*            Let parent POM figure out commons.spdx.version. Thanks to Gary Gregory.
* LANG-1726: Undeprecate ExceptionUtils.rethrow(Throwable). Thanks to V�clav Haisman, Gary Gregory.
* LANG-1702: Test the Conversion class #1155. Thanks to Elliotte Rusty Harold.
*            Address minor redundancies after code inspection #1148. Thanks to ParanoidUser, Elliotte Rusty Harold, Gary Gregory.
*            Allow EventListenerSupport to handle (and ignore) exception from listeners allowing invocation of all listeners #1167. Thanks to Gary Gregory.
*            Deprecate AnnotationUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ArchUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ArrayUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate BooleanUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate CharSequenceUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate CharSetUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate CharUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ClassLoaderUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ClassPathUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ClassUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ConstructorUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate DateFormatUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate DateUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate Diff.getType(). Thanks to Gary Gregory.
*            Deprecate DiffBuilder.DiffBuilder(T, T, ToStringStyle). Thanks to Gary Gregory.
*            Deprecate DiffBuilder.DiffBuilder(T, T, ToStringStyle, boolean). Thanks to Gary Gregory.
*            Deprecate DurationFormatUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate DurationUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate EnumUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate EventUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate FieldUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate IEEE754rUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate InheritanceUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate IntStreams 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate LocaleUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate LockingVisitors 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate MemberUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate MethodUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate NumberUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ObjectUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate RandomStringUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate RandomUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ReflectionDiffBuilder.ReflectionDiffBuilder(T, T, ToStringStyle). Thanks to Gary Gregory.
*            Deprecate RegExUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate SerializationUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate Streams 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate StringEscapeUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate StringUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate Suppliers 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate SystemProperties 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate ThreadUtils 0-argument constructor. Thanks to Gary Gregory.
*            Deprecate TypeUtils 0-argument constructor. Thanks to Gary Gregory.
*            Make ArrayFill null-safe. Thanks to Gary Gregory.
*            Make ArraySorter null-safe. Thanks to Gary Gregory.
*            Make ArrayUtils.removeAll() null-safe. Thanks to Gary Gregory.
*            Fix Java version in README.md #1170. Thanks to Philipp Trulson, Gary Gregory.
*            StringUtils.stripAccents() should handle ligatures, UTF32 math blocks, etc. #1201. Thanks to Stephan Peters, Gary Gregory, Bernd.
* LANG-1524: TypeUtils.toString(Type) StackOverflowError for an inner class in the inner class parameterized enclosing class #657. Thanks to kijong.youn, Aakash Gupta, Gary Gregory.
*            Deprecate SystemUtils.getUserName(String) in favor of SystemProperties.getUserName(Supplier). Thanks to Gary Gregory.
*            Make LockVisitor.acceptReadLocked(FailableConsumer) null-safe. Thanks to Gary Gregory.
*            Make LockVisitor.applyWriteLocked(FailableConsumer) null-safe. Thanks to Gary Gregory.
*            Make ObjectUtils.getFirstNonNull(Supplier...) null-safe. Thanks to Gary Gregory.
*            Make SystemProperties.getLineSeparator(Supplier). Thanks to Gary Gregory.
*            StringUtils.stripAccents(String) doesn't handle "\u0111" and "\u0110" (Vietnamese) #1216. Thanks to hunghhdev.
*            StringUtils.stripAccents(String) doesn't handle I with bar. Thanks to Gary Gregory.
*            StringUtils.stripAccents(String) doesn't handle U with bar. Thanks to Gary Gregory.
*            StringUtils.stripAccents(String) doesn't handle T with stroke. Thanks to Gary Gregory.
* LANG-1735: Fix Javadoc for FluentBitSet.setInclusive(int, int) #1222. Thanks to Tobias Kiecker.
*            Same Javadoc changes as [TEXT-234] #1223. Thanks to Tobias Kiecker.
*            Remove duplicate static data in SerializationUtils.ClassLoaderAwareObjectInputStream. Thanks to Gary Gregory.
*            Reimplement RandomUtils and RandomStringUtils on top of SecureRandom#getInstanceStrong() #1235. Thanks to Gary Gregory, Henri Yandell, Fabrice Benhamouda.
* LANG-1657: DiffBuilder: Type constraint for method append(..., DiffResult) too strict #786. Thanks to Matthias Welz, Andrew Thomas, Gary Gregory.

Changes:
*            Bump commons-parent from 64 to 71 #1194, #1233. Thanks to Dependabot, Gary Gregory.
*            Bump org.codehaus.mojo:exec-maven-plugin from 3.1.1 to 3.3.0 #1175, #1224. Thanks to Dependabot.
*            Bump org.apache.commons:commons-text from 1.11.0 to 1.12.0 #1200. Thanks to Dependabot.
*            Bump org.easymock:easymock from 5.2.0 to 5.3.0 #1232. Thanks to Dependabot.
*            Bump org.codehaus.mojo:taglist-maven-plugin from 3.0.0 to 3.1.0 #1242. Thanks to Dependabot.

Removed:
*            Drop obsolete JDK 13 Maven profile #1142. Thanks to Parano�d User.

Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
-Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.14.0 Release Notes
----------------------------------------

This document contains the release notes for the 3.14.0 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any 
Java environment.

Lang 3.9 and onwards now targets Java 8, making use of features that arrived with Java 8.

For the advice on upgrading from 2.x to 3.x, see the following page: 

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

New features and bug fixes (Java 8 or above).

Changes in this version include:

New features:
*            Add Functions#function(Function). Thanks to Rob Spoor, Gary Gregory.
*            Add FailableFunction#function(FailableFunction). Thanks to Rob Spoor, Gary Gregory.
*            Add CalendarUtils.getInstance(). Thanks to Gary Gregory.
*            Add syntax for optional tokens to DurationFormatUtils #1062. Thanks to Dan Watson.
*            Add ArrayFill. Thanks to Gary Gregory.
*            Add FastDateParser.TimeZoneStrategy.TzInfo.toString(). Thanks to Gary Gregory.
*            Add LocaleUtils.isLanguageUndetermined(Locale). Thanks to Gary Gregory.
*            Add ObjectUtils.toString(Supplier<Object>, Supplier<String>). Thanks to Gary Gregory.
*            Add LazyInitializer.isInitialized(). Thanks to Gary Gregory.
*            Add ConcurrentInitializer#isInitialized() #1120. Thanks to Benjamin Confino, Gary Gregory.
*            Add Streams.failableStream(T...). Thanks to Gary Gregory.
*            Add FailableSupplier.nul(). Thanks to Gary Gregory.
*            Add Suppliers.nul(). Thanks to Gary Gregory.
*            Add ExceptionUtils.throwUnchecked(T) where T extends Throwable, and deprecate Object version. Thanks to Gary Gregory.
*            Add ExceptionUtils.rethrowRuntimeException(T), and deprecate rethrow(T). Thanks to Gary Gregory.
* LANG-1716: ConcurrentInitializer implementations can now be instantiated and configured with allocation and release lambdas. Thanks to Benjamin Confino, Gary Gregory.
* LANG-1717: Add support for RISC-V in ArchUtils #1128. Thanks to Levi Zim, Gary Gregory.

Fixed Bugs:
*            Rename variable names from 'clss' to 'clazz' #1087. Thanks to remeio.
*            [Javadoc] ComparableUtils'c1' to 'comparable1', 'c2' to ' Thanks to remeio.
*            [Javadoc] Remove 2.1 specific comment #1091. Thanks to Elliotte Rusty Harold.
* LANG-1704: ImmutablePair and ImmutableTriple implementation don't match final in Javadoc. Thanks to Dan Ziemba, Gilles Sadowski, Alex Herbert, Gary Gregory.
*            [Javadoc] Fix Incorrect Description in Processor isAarch64() #1093. Thanks to Sung Ho Yoon.
*            [Javadoc] Point to right getShortClassName flavor in Javadoc for relevant notes #1097. Thanks to ljacqu.
*            Improve performance of StringUtils.isMixedCase() #1096. Thanks to hduelme.
* LANG-1706: ThreadUtils find methods should not return null items #1098. Thanks to Alberto Fern�ndez.
* LANG-1710: ReflectionToStringBuilder changes in version 3.13.0 has broken the logic for overriding classes. Thanks to Shashank Sharma, Gary Gregory, Oksana.
*            Return "null" instead of NPE in ClassLoaderUtils.toString(ClassLoader). Thanks to Gary Gregory.
*            Return "null" instead of NPE in ClassLoaderUtils.toString(URLClassLoader). Thanks to Gary Gregory.
*            Return ToStringStyle.nullText instead of NPE for ReflectionToStringBuilder.toString(). Thanks to Gary Gregory.
*            Fix ThresholdCircuitBreaker#checkState() #1100. Thanks to yichinzhu, Gary Gregory.
*            Use ConcurrentInitializer implementations without subclassing. #1123. Thanks to Benjamin Confino, Gary Gregory.
*            Update critical value for chi-square test #1125. Thanks to Alex Herbert.
*            Fix Javadoc syntax errors #1129. Thanks to Sung Ho Yoon.

Changes:
*            Bump commons-parent from 58 to 64. Thanks to Gary Gregory.
*            Bump org.easymock:easymock from 5.1.0 to 5.2.0 #1104. Thanks to Gary Gregory.
*            Bump commons-text from 1.10.0 to 1.11.0. Thanks to Gary Gregory.
*            Bump org.codehaus.mojo:exec-maven-plugin from 3.1.0 to 3.1.1 #1135. Thanks to Gary Gregory.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
-Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.13.0 Release Notes
----------------------------------------


This document contains the release notes for the 3.13.0 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any 
Java environment.

Lang 3.9 and onwards now targets Java 8, making use of features that arrived with Java 8.

For the advice on upgrading from 2.x to 3.x, see the following page: 

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

New features and bug fixes (Java 8 or above).

Changes in this version include:

New features:
*            Add GitHub coverage.yml. Thanks to Gary Gregory.
*            Add EnumUtils.getEnumSystemProperty(...). Thanks to Gary Gregory.
*            Add TriConsumer. Thanks to Gary Gregory.
*            Add and use EnumUtils.getFirstEnumIgnoreCase(Class, String, Function, E). Thanks to Gary Gregory.
*            Add and use Suppliers. Thanks to Gary Gregory.
*            Add and use ArrayUtils.getComponentType(T[]). Thanks to Gary Gregory.
*            Add and use ClassUtils.getComponentType(Class>T[]>). Thanks to Gary Gregory.
*            Add and use ObjectUtils.getClass(T). Thanks to Gary Gregory.
*            Add and use ArrayUtils.newInstance(Class>T>, int). Thanks to Gary Gregory.
*            Add and use null-safe Streams.of(T...). Thanks to Gary Gregory.
*            Add ClassUtils.comparator(). Thanks to Gary Gregory.
*            Add and use ThreadUtils.sleepQuietly(Duration). Thanks to Gary Gregory.
*            Add and use ArrayUtils.setAll(T[], IntFunction). Thanks to Gary Gregory.
*            Add and use ArrayUtils.setAll(T[], Supplier). Thanks to Gary Gregory.
*            Add BooleanConsumer. Thanks to Gary Gregory.
*            Add IntToCharFunction. Thanks to Gary Gregory.
*            Add IntStreams. Thanks to Gary Gregory.
*            Add UncheckedFuture. Thanks to Gary Gregory.
*            Add UncheckedException. Thanks to Gary Gregory.
*            Add UncheckedExecutionException. Thanks to Gary Gregory.
*            Add UncheckedTimeoutException. Thanks to Gary Gregory.
*            Add UncheckedInterruptedException. Thanks to Gary Gregory.
*            Add TimeZones.GMT. Thanks to Gary Gregory.
*            Add ObjectUtils.identityHashCodeHex(Object). Thanks to Gary Gregory.
*            Add ObjectUtils.hashCodeHex(Object). Thanks to Gary Gregory.
*            Add StringUtils.removeStart(String, char). Thanks to Gary Gregory.
* LANG-1659: Add null-safe ObjectUtils.isArray() #754. Thanks to Arturo Bernal, Gary Gregory.
*            Add ComparableUtils.max(A, A) and ComparableUtils.min(A, A). Thanks to Gary Gregory.
*            Add UncheckedReflectiveOperationException. Thanks to Gary Gregory.
*            Add and use ClassUtils.isPublic(Class). Thanks to Gary Gregory.
*            Add UncheckedIllegalAccessException. Thanks to Gary Gregory.
*            Add MethodInvokers. Thanks to Gary Gregory.
*            Add Streams.nullSafeStream(Collection). Thanks to Gary Gregory.
*            Add Streams.toStream(Collection). Thanks to Gary Gregory.
*            Add Streams.failableStream(Collection) and deprecate misnamed stream(Collection). Thanks to Gary Gregory.
*            Add Streams.failableStream(Stream) and deprecate misnamed stream(Stream). Thanks to Gary Gregory.
*            Add EnumUtils.getEnumMap(Class, Function). #730 Thanks to Maxwell Cody, Gary Gregory.
*            Add FluentBitSet. Thanks to Gary Gregory.
*            Add Streams.instancesOf(Class, Collection). Thanks to Gary Gregory.
*            Add ImmutablePair.ofNonNull(L, R). Thanks to Gary Gregory.
*            Add ImmutableTriple.ofNonNull(L, M, R). Thanks to Gary Gregory.
*            Add MutablePair.ofNonNull(L, R). Thanks to Gary Gregory.
*            Add MutableTriple.ofNonNull(L, M, R). Thanks to Gary Gregory.
*            Add Pair.ofNonNull(L, R). Thanks to Gary Gregory.
*            Add Triple.ofNonNull(L, M, R). Thanks to Gary Gregory.
*            Add ArrayUtils.containsAny(Object[], Object...). Thanks to Gary Gregory.
*            Add Processor.Type.AARCH_64. Thanks to Gary Gregory.
*            Add Processor.isAarch64(). Thanks to Gary Gregory.
*            Update ArchUtils.getProcessor(String) for "aarch64". Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_18. Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_19. Thanks to Emmanuel Bourg.
*            Add JavaVersion.JAVA_20. Thanks to Emmanuel Bourg.
*            Add JavaVersion.JAVA_21. Thanks to Emmanuel Bourg.
*            Add TimeZones.toTimeZone(TimeZone). Thanks to Gary Gregory.
*            Add FutureTasks. Thanks to Gary Gregory.
*            Add Memoizer(Function) and Memoizer(Function, boolean). Thanks to Gary Gregory.
*            Add Consumers. Thanks to Gary Gregory.
*            Add github/codeql-action. Thanks to Gary Gregory.
*            Add coverage.yml. Thanks to Gary Gregory.
*            Add DurationUtils.since(Temporal). Thanks to Gary Gregory.
*            Add DurationUtils.of(FailableConsumer|FailableRunnbale). Thanks to Gary Gregory.
*            Add ExceptionUtils.forEach(Throwable, Consumer<Throwable>). Thanks to Gary Gregory.
*            Add ExceptionUtils.stream(Throwable). Thanks to Gary Gregory.
*            Add ExceptionUtils.getRootCauseStackTraceList(Throwable). Thanks to Gary Gregory.
*            Add SystemUtils.IS_OS_WINDOWS_11. Thanks to Will Herrmann, Gary Gregory, Roland Kreuzer.
*            Add SystemUtils.IS_JAVA_16. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_17. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_18. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_19. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_20. Thanks to Gary Gregory.
*            Add SystemUtils.IS_JAVA_21. Thanks to Emmanuel Bourg.
* LANG-1627: Add ArrayUtils.oneHot(). Thanks to Alberto Scotto, Avijit Chakraborty, Steve Bosman, Bruno P. Kinoshita, Gary Gregory.
* LANG-1662: Let ReflectionToStringBuilder only reflect given field names #849. Thanks to Daniel Augusto Veronezi Salvador, Gary Gregory, Bruno P. Kinoshita.
*            Add Streams.of(Enumeration<E>). Thanks to Gary Gregory.
*            Add Streams.of(Iterable<E>). Thanks to Gary Gregory.
*            Add Streams.of(Iterator<E>). Thanks to Gary Gregory.
* LANG-1689: Simple support for Optional in ObjectUtils#isEmpty() #933. Thanks to Joseph Hendrix, Gary Gregory.
*            Add Processor.Type.getLabel(). Thanks to Gary Gregory.
*            Add Processor.toString(). Thanks to Gary Gregory.
*            Add HashCodeBuilder.equals(Object). Thanks to Gary Gregory.
*            Add BooleanUtils.values() and forEach(). Thanks to Gary Gregory.
*            Add ClassPathUtils.packageToPath(String) and pathToPackage(String) Thanks to Gary Gregory.
*            Add CalendarUtils#getDayOfYear() #968 Thanks to Arturo Bernal.
*            Add NumberRange, DoubleRange, IntegerRange, LongRange. Thanks to Gary Gregory.
*            Add missing exception javadoc/tests for some null arguments #869. Thanks to Diego Marcilio, Bruno P. Kinoshita, Gary Gregory.
*            Add ClassLoaderUtils.getSystemURLs() and getThreadURLs(). Thanks to Gary Gregory.
*            Add RegExUtils.dotAll() and dotAllMatcher(). Thanks to Gary Gregory.
*            Add Pair.accept(FailableBiConsumer). Thanks to Gary Gregory.
*            Add Pair.apply(FailableBiFunction). Thanks to Gary Gregory.
* LANG-1677: Add ReflectionDiffBuilder.setExcludeFieldNames(...) and DiffExclude a? #838. Thanks to Dennis Baerten, Gary Gregory.
* LANG-1647: Add and ExceptionUtils.isChecked() and isUnchecked() #1069 Thanks to Arturo Bernal, Dimitrios Efthymiou, Gary Gregory.
*            Add and use ExceptionUtils.throwUnchecked(throwable). Thanks to Gary Gregory.
*            Add LockingVisitors.create(O, ReadWriteLock). Thanks to Gary Gregory.

Fixed Bugs:
* LANG-1645: NumberUtils.createNumber() to recognize hex integers prefixed with +. Thanks to Alex Herbert.
* LANG-1646: NumberUtils.createNumber() to return requested floating point type for zero. Thanks to Alex Herbert.
*            DMI: Random object created and used only once (DMI_RANDOM_USED_ONLY_ONCE); Better multi-threaded behavior. Thanks to SpotBugs, Gary Gregory.
* LANG-1646: Redundant Collection operation. Use Collections.emptyIterator() #738. Thanks to Arturo Bernal.
*            Make Streams.stream(Collection) null-safe. Thanks to Gary Gregory.
* LANG-1667: Allow tests to access java.util classes such as ArrayList in Java 16 #788. Thanks to Andrew Thomas.
* LANG-1669: OpenJDK 16 Day Period Parsing #791. Thanks to Andrew Thomas.
* LANG-1663: Update documentation to list correct exception for null array parameters #785. Thanks to Andrew Thomas.
*            Fixing reversed Javadoc descriptions in StopWatch #781. Thanks to Thunderforge.
* LANG-1670: Fix typos in JavaDoc #795. Thanks to Igor Shuvalov.
*            Simplify assertions with equivalent but more simple. #792. Thanks to Arturo Bernal.
*            Avoid multiple equivalent occurrences of the same expression. #797. Thanks to Arturo Bernal.
*            Remove redundant initializers #800. Thanks to Arturo Bernal.
*            Fix ObjectUtils Javadocs #755. Thanks to Arturo Bernal.
*            Add test idea for RangeTest from PR #815 by Rushi98, but with a new comment. Thanks to Rushi98, Gary Gregory.
* LANG-1674: Make Range constructors more generic #810. Thanks to singhbaljit, Gary Gregory.
*            Use final and Remove redundant String. #813, #816. Thanks to Arturo Bernal.
*            Use Set instead of List for checking the contains() method #734. Thanks to CiprianBodnarescu.
*            Javadoc for StringUtils.substringBefore(String str, int separator) doesn't mention that the separator is an int. Thanks to Roland Kreuzer.
*            Fix NullPointerException in ThreadUtils.getSystemThreadGroup() when the current thread is stopped. Thanks to Gary Gregory.
*            ArrayUtils.toPrimitive(Boolean...) null array elements map to false, like Boolean.parseBoolean(null) and its callers return false. Thanks to Gary Gregory.
*            StrBuilder.StrBuilderReader.skip(long): Throw an exception when an implicit narrowing conversion in a compound assignment would result in information loss or a numeric error such as an overflows. Thanks to CodeQL, Gary Gregory.
*            Deprecate Validate#notNull(Object) in favor of using Objects#requireNonNull(Object, String). Thanks to Gary Gregory.
* LANG-1462: Use TimeZone from calendar in DateFormatUtils. Thanks to Lijun Liang, Arun Avanathan, Tai Dupree, Maria Buiakova, Gary Gregory.
*            Updating javadoc for NullPointerException when Validate.notNull() is called #870. Thanks to Diego Marcilio.
*            Fixing and adding DateUtils exception Javadocs #871. Thanks to Diego Marcilio.
* LANG-1679: Improve performance of StringUtils.unwrap(String, String) #844. Thanks to clover.
* LANG-1675: Improve performance of StringUtils.join for primitives #812. Thanks to clover.
* LANG-1675: Fixed NPE getting Stack Trace if Throwable is null #733. Thanks to Arturo Bernal.
*            Make Validate.isAssignableFrom() check null inputs. Thanks to Gary Gregory, Arturo Bernal.
*            Fix Javadoc for Validate.isAssignableFrom(). Thanks to Arturo Bernal.
*            Make final mappingFunction variable #876. Thanks to Arturo Bernal.
*            Remove unnecessary variable creations #882. Thanks to Arturo Bernal.
*            Minor changes #769. Thanks to Arturo Bernal.
* LANG-1680: FastDateFormat does not support the 'L'-Pattern from SimpleDateFormat. Thanks to Michael Krause, Steve Bosman, Gary Gregory.
*            Increase test coverage of ComparableUtils from 71% to 100% #898. Thanks to Steve Bosman, Gary Gregory.
*            Increase method test coverage of MultilineRecursiveToStringStyle #899. Thanks to Steve Bosman.
*            Fix unstable coverage of CharSequenceUtils tests noticed during merge of PRs 898 and 899 #901. Thanks to Steve Bosman.
*            Rewrite Conversion.binaryBeMsb0ToHexDigit to invert logic of binaryToHexDigit. Thanks to Arturo Bernal.
*            Allow extension of previously final classes ImmutablePair and ImmutableTriple. Thanks to Gary Gregory.
*            Update ClassUtils Javadoc with some missing throws NPE #912. Thanks to shalk, Bruno P. Kinoshita, Gary Gregory.
*            Javadoc: StringUtils.repeat("", "x", 3) = "xx"; #918. Thanks to guicaiyue.
*            Fix typos #920, #923. Thanks to Marc Wrobel.
*            Simplify condition #925. Thanks to Bhimantoro Suryo Admodjo.
*            StringUtils.join(Iterable, String) should only return null when the Iterable is null. Thanks to Gary Gregory.
*            StringUtils.join(Iterator, String) should only return null when the Iterator is null. Thanks to Gary Gregory.
*            Add tests to increase coverage #904. Thanks to Arturo Bernal.
*            Extends Object clauses are redundant #937. Thanks to Arturo Bernal.
*            Simplify conditional expression. #941. Thanks to Arturo Bernal.
*            Fix some Javadoc comments #938. Thanks to Arturo Bernal.
*            Deprecate getNanosOfMiili() method with typo and create proper getNanosOfMilli() #940. Thanks to Arturo Bernal, Gary Gregory.
*            Deprecate ThreadUtils code that defines custom function interfaces in favor of stock java.util.function.Predicate usage. Thanks to Gary Gregory.
*            Fix links in Javadoc and documentation #926. Thanks to Marc Wrobel.
* LANG-1604: Deprecate RandomUtils in favor of Apache Commons RNG UniformRandomProvider #942. Thanks to Gilles Sadowski, Maksym Bohachov, Gary Gregory.
* LANG-1638: Added docs regarding week year support #924. Thanks to Shailendra Soni, Michael Osipov, Arun Avanathan, Andrew Thomas, Bruno P. Kinoshita, Gary Gregory.
* LANG-1691: ClassUtils.getShortCanonicalName doesn't use the canonicalName #949. Thanks to Thiyagarajan, Gary Gregory.
*            Validate: Get error messages without using String.format when varargs is empty. Thanks to Piotr Stawirej.
*            Simplify expression (length is never < 0) #962. Thanks to Arturo Bernal.
*            Fix simple broken javadoc. #981. Thanks to Arturo Bernal.
*            Fix typo #1001. Thanks to LeeJuHyun.
*            Use Objects.requireNonNull() directly #1022. Thanks to Arturo Bernal.
* LANG-1694: MethodUtils.getMatchingMethod() fails with "Found multiple candidates" #1033. Thanks to SeasonPan.
* LANG-1643: Construct ArrayList with better default size #1041. Thanks to laurentschoelens.
*            ThreadUtilsTest#testThreadGroups will test failed when using Junit5 parallel test #1051. Thanks to remeio.
*            Swap the order of assertion args (first excepted then actual) #1054. Thanks to remeio.
*            Fix the comment of Failable, redundant "-" #1056. Thanks to remeio.
*            Fix the comment of ComparableUtils, using "smallest", not "largest" #1058. Thanks to remeio.
*            AnnotationUtilsTest and FormattableUtilsTest Only use static imports to import assert methods in tests #1052. Thanks to remeio.
*            [LANG-1681] Fix some FieldUtils Javadocs #1047. Thanks to laurentschoelens, Bruno P. Kinoshita, Diego Marcilio.
*            Remove unnecessary statement in DurationFormatUtils #965. Thanks to Arturo Bernal.
* LANG-1699: Corrected value of SystemUtils.JAVA_VENDOR #1066. Thanks to Darren Coleman.
*            [StepSecurity] ci: Harden GitHub Actions #1067. Thanks to step-security-bot, Gary Gregory.
*            Update Javadoc for the insert methods in ArrayUtils #1078. Thanks to Dimitrios Efthymiou.
*            Deprecate ExceptionUtils.ExceptionUtils(). Thanks to Gary Gregory.
* LANG-1697: TypeUtils.getRawType() throws a NullPointerException on Wildcard GenericArrayType. Thanks to Jan Arne Sparka, Gary Gregory.
*            Throw IllegalArgumentException instead of InternalError in the builder package. Thanks to Gary Gregory.
*            Avoid NPE in MutableObject#equals() for null content. Thanks to Gary Gregory.
*            SystemUtils fix and updates related to macOS #1085. Thanks to Ali Khaleqi Yekta, Gary Gregory.

Changes:
*            Bump actions/cache from 2.1.4 to 3.0.10 #742, #752, #764, #833, #867, #959, #964. Thanks to Dependabot, XenoAmess, Gary Gregory.
*            Bump actions/checkout from 2 to 3.1.0 #819, #825, #859, #963. Thanks to Dependabot, Gary Gregory.
*            Bump actions/setup-java from v1.4.3 to 3.5.1 #879. Thanks to Gary Gregory.
*            Bump spotbugs-maven-plugin from 4.2.0 to 4.7.3.0 #735, #808, #822, #834, #868, #895, #919, #927, #946, #989. Thanks to Dependabot, Gary Gregory.
*            Bump spotbugs from 4.2.2 to 4.7.3 #744, #917, #947, #973. Thanks to Dependabot, Gary Gregory.
*            Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #943. Thanks to Dependabot, Gary Gregory.
*            Bump checkstyle from 8.41 to 9.3 #739, #768, #787, #811, #824, #843. Thanks to Dependabot, Gary Gregory.
*            Bump easymock from 4.2 to 5.1.0 #746, #972, #986, #1012. Thanks to Dependabot.
*            Bump commons.jacoco.version from 0.8.6 to 0.8.8. Thanks to Gary Gregory.
*            Bump commons.japicmp.version from 0.15.2 to 0.16.0. Thanks to Gary Gregory.
*            Bump junit-pioneer from 1.3.8 to 1.9.1 #749, #767, #832, #883, #988, #991, #995. Thanks to Dependabot, Gary Gregory.
*            Bump junit-bom from 5.7.1 to 5.9.1 #761, #805, #807, #836, #928, #955. Thanks to Dependabot.
*            Bump maven-javadoc-plugin from 3.2.0 to 3.4.1. Thanks to Dependabot, Gary Gregory.
*            Bump jmh.version from 1.27 to 1.36 #794, #842, #872, #990. Thanks to Dependabot.
*            Bump maven-pmd-plugin from 3.14.0 to 3.19.0 #802, #858, #909, #948. Thanks to Dependabot.
*            Bump pmd from 6.40.0 to 6.52.0 #837, #861, #873, #905, #915, #932, #944. Thanks to Dependabot.
*            Bump biz.aQute.bndlib from 5.3.0 to 6.3.1 #814, #835. Thanks to Dependabot, Gary Gregory.
*            Bump maven-bundle-plugin from 5.1.1 to 5.1.2. Thanks to Dependabot.
*            Bump animal-sniffer-maven-plugin from 1.19 to 1.21. Thanks to Dependabot.
*            Bump exec-maven-plugin from 1.6.0 to 3.1.0 #590, #922. Thanks to Dependabot.
*            Bump maven-surefire-plugin from 3.0.0-M5 to 3.0.0-M7 #880, #910. Thanks to Dependabot.
*            Bump apache-rat from 0.13 to 0.14. Thanks to Gary Gregory.
*            Bump commons-parent from 53 to 58 #954, #1000, #1011, #1061. Thanks to Dependabot, Gary Gregory.
*            Bump commons-text from 1.9 to 1.10.0 #957. Thanks to Dependabot.
*            Bump commons.pmd-impl.version from 6.49.0 to 6.51.0 #961. Thanks to Dependabot, Gary Gregory.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
-Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.12.0 Release Notes
----------------------------------------

INTRODUCTION:

This document contains the release notes for the 3.12.0 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any 
Java environment.

Lang 3.9 and onwards now targets Java 8, making use of features that arrived with Java 8.

For the advice on upgrading from 2.x to 3.x, see the following page: 

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

New features and bug fixes.

Changes in this version include:

New features:
*            Add BooleanUtils.booleanValues(). Thanks to Gary Gregory.
*            Add BooleanUtils.primitiveValues(). Thanks to Gary Gregory.
* LANG-1535: Add StringUtils.containsAnyIgnoreCase(CharSequence, CharSequence...). Thanks to Gary Gregory, Isira Seneviratne.
* LANG-1359: Add StopWatch.getStopTime(). Thanks to Gary Gregory, Keegan Witt.
*            More test coverage for CharSequenceUtils. #631. Thanks to Edgar Asatryan.
*            Add fluent-style ArraySorter. Thanks to Gary Gregory.
*            Add and use LocaleUtils.toLocale(Locale) to avoid NPEs. Thanks to Gary Gregory.
*            Add FailableShortSupplier, handy for JDBC APIs. Thanks to Gary Gregory.
*            Add JavaVersion.JAVA_17. Thanks to Gary Gregory.
* LANG-1636: Add missing boolean[] join method #686. Thanks to .
*            Add StringUtils.substringBefore(String, int). Thanks to Gary Gregory.
*            Add Range.INTEGER. Thanks to Gary Gregory.
*            Add DurationUtils. Thanks to Gary Gregory.
*            Introduce the use of @Nonnull, and @Nullable, and the Objects class as a helper tool.
*            Add and use true and false String constants #714. Thanks to Arturo Bernal, Gary Gregory.
*            Add and use ObjectUtils.requireNonEmpty() #716. Thanks to Arturo Bernal, Gary Gregory.

Fixed Bugs:
* LANG-1592: Correct implementation of RandomUtils.nextLong(long, long) Thanks to Huang Pingcai, Alex Herbert.
* LANG-1600: Restore handling of collections for non-JSON ToStringStyle #610. Thanks to Michael F.
*            ContextedException Javadoc add missing semicolon #581. Thanks to iamchao1129.
* LANG-1608: Resolve JUnit pioneer transitive dependencies using JUnit BOM. Thanks to Edgar Asatryan.
*            NumberUtilsTest - incorrect types in min/max tests #634. Thanks to HubertWo, Gary Gregory.
* LANG-1579: Improve StringUtils.stripAccents conversion of remaining accents. Thanks to XenoAmess.
* LANG-1606: StringUtils.countMatches - clarify Javadoc. Thanks to Rustem Galiev.
* LANG-1591: Remove redundant argument from substring call. Thanks to bhawna94.
* LANG-1613: BigDecimal is created when you pass it the min and max values, #642. Thanks to Arturo Bernal, Gary Gregory.
* LANG-1541: ArrayUtils.contains() and indexOf() fail to handle Double.NaN #647. Thanks to Arturo Bernal, Gary Gregory.
* LANG-1615: ArrayUtils contains() and indexOf() fail to handle Float.NaN # #561. Thanks to Arturo Bernal, Gary Gregory.
*            Fix potential NPE in TypeUtils.isAssignable(Type, ParameterizedType, Map, Type>). Thanks to Gary Gregory.
* LANG-1420: TypeUtils.isAssignable returns wrong result for GenericArrayType and ParameterizedType, #643. Thanks to Gordon Fraser, Rostislav Krasny, Arturo Bernal, Gary Gregory.
* LANG-1612: testGetAllFields and testGetFieldsWithAnnotation sometimes fail. Thanks to XinT, Gary Gregory.
*            Fix Javadoc for SystemUtils.isJavaVersionAtMost() #638. Thanks to John R. D'Orazio.
* LANG-1610: Fix StringUtils.unwrap throws StringIndexOutOfBoundsException #636. Thanks to Tony Liang.
*            Fix formatting of isAnyBlank() and isAnyEmpty(). #513. Thanks to Isira Seneviratne.
* LANG-1618: TypeUtils. containsTypeVariables does not support GenericArrayType #661. Thanks to Arturo Bernal.
* LANG-1622: Javadoc of some methods incorrectly refers to another method, #667, #668. #670. Thanks to Kanak Sony, anomen-s.
* LANG-1620: Refine StringUtils.lastIndexOfIgnoreCase #664. Thanks to Arturo Bernal.
* LANG-1619: Refine StringUtils.abbreviate #663. Thanks to Arturo Bernal.
* LANG-1584: Refine StringUtils.isNumericSpace #573. Thanks to Arturo Bernal.
* LANG-1580: Refine StringUtils.deleteWhitespace #569. Thanks to Arturo Bernal.
* LANG-1626: Correction in Javadoc of some methods. #673 Thanks to Kanak Sony.
* LANG-1628: Javadoc for RandomStringUtils.random() letters, numbers parameters is wrong. Thanks to Jarkko Rantavuori.
*            Correct markup in Javadoc for unbalanced braces #679. Thanks to Felix Schumacher.
* LANG-1544: MethodUtils.invokeMethod NullPointerException in case of null in args list #680. Thanks to Peter Nagy, Michael Buck, Gary Gregory.
* LANG-1637: Fix 2 digit week year formatting #688. Thanks to Uri Gonen, Gary Gregory, Michael Osipov.
*            Fix broken Javadoc links to commons-text #712. Thanks to Chris Smowton.
*            Add and use ThreadUtils.sleep(Duration). Thanks to Gary Gregory.
*            Add and use ThreadUtils.join(Thread, Duration). Thanks to Gary Gregory.
*            Add ObjectUtils.wait(Duration). Thanks to Gary Gregory.

Changes:
* LANG-1596: ArrayUtils.toPrimitive(Object) does not support boolean and other types #607. Thanks to Richard Eckart de Castilho.
*            Enable Dependabot #587. Thanks to Gary Gregory.
*            Bump junit-jupiter from 5.6.2 to 5.7.0.
*            Bump spotbugs from 4.1.2 to 4.2.1, #627, #671, #708. Thanks to chtompki, Dependabot.
*            Bump spotbugs-maven-plugin from 4.0.0 to 4.2.0, #593, #596, #609, #623, #632, #692. Thanks to Dependabot.
*            Bump biz.aQute.bndlib from 5.1.1 to 5.3.0 #592, #628, #715. Thanks to Dependabot.
*            Bump junit-pioneer from 0.6.0 to 1.1.0, #589, #597, #600, #624, #625, #662. Thanks to Dependabot.
*            Bump checkstyle from 8.34 to 8.40, #594, #614, #637, #665, #706. Thanks to Dependabot.
*            Bump actions/checkout from v2.3.1 to v2.3.4 #601, #639. Thanks to Dependabot.
*            Bump actions/setup-java from v1.4.0 to v1.4.2 #612. Thanks to Dependabot.
*            Update commons.jacoco.version 0.8.5 to 0.8.6 (Fixes Java 15 builds). Thanks to Gary Gregory.
*            Update maven-surefire-plugin 2.22.2 -> 3.0.0-M5. Thanks to Gary Gregory.
*            Bump maven-pmd-plugin from 3.13.0 to 3.14.0 #660. Thanks to Dependabot.
*            Bump jmh.version from 1.21 to 1.27 #674. Thanks to Dependabot.
*            Update commons.japicmp.version 0.14.3 -> 0.15.2. Thanks to Gary Gregory.
*            Processor.java: check enum equality with == instead of .equals() method #690. Thanks to Ali K. Nouri.
*            Bump junit-pioneer from 1.1.0 to 1.3.0 #702. Thanks to Dependabot.
*            Bump maven-checkstyle-plugin from 3.1.1 to 3.1.2 #705. Thanks to Dependabot.
*            Bump actions/cache from v2 to v2.1.4 #710. Thanks to Dependabot.
*            Bump junit-bom from 5.7.0 to 5.7.1 #707. Thanks to Dependabot.
*            Minor Improvements #701. Thanks to Arturo Bernal.
*            Minor Improvement: Add final variable.try to make the code read-only #700. Thanks to Arturo Bernal.
*            Minor Improvement: Remove redundant initializer #699. Thanks to Arturo Bernal.
*            Use own validator ObjectUtils.anyNull to check null String input #718. Thanks to Arturo Bernal.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
-Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.11.0 Release Notes
----------------------------------------


INTRODUCTION:

This document contains the release notes for the 3.11 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any 
Java environment.

Lang 3.9 and onwards now targets Java 8, making use of features that arrived with Java 8.

For the advice on upgrading from 2.x to 3.x, see the following page: 

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

New features and bug fixes.

Changes in this version include:

New features:
*            Add ArrayUtils.isSameLength() to compare more array types #430. Thanks to XenoAmess, Gary Gregory.
*            Added the Locks class as a convenient possibility to deal with locked objects.
* LANG-1568: Add to Functions: FailableBooleanSupplier, FailableIntSupplier, FailableLongSupplier, FailableDoubleSupplier, and so on.
* LANG-1569: Add ArrayUtils.get(T[], index, T) to provide an out-of-bounds default value.
* LANG-1570: Add JavaVersion enum constants for Java 14 and 15. #553. Thanks to Edgar Asatryan.
*            Add JavaVersion enum constants for Java 16. Thanks to Gary Gregory.
* LANG-1556: Use Java 8 lambdas and Map operations. Thanks to XenoAmess.
* LANG-1565: Change removeLastFieldSeparator to use endsWith #550. Thanks to XenoAmess.
* LANG-1557: Change a Pattern to a static final field, for not letting it compile each time the function invoked. #542. Thanks to XenoAmess, Gary Gregory.
*            Add ImmutablePair factory methods left() and right().
*            Add ObjectUtils.toString(Object, Supplier<String>).
*            Add org.apache.commons.lang3.StringUtils.substringAfter(String, int).
*            Add org.apache.commons.lang3.StringUtils.substringAfterLast(String, int).

Fixed Bugs:
*            Fix Javadoc for StringUtils.appendIfMissingIgnoreCase() #507. Thanks to contextshuffling.
* LANG-1560: Refine Javadoc #545. Thanks to XenoAmess.
* LANG-1554: Fix typos #539. Thanks to XenoAmess.
* LANG-1555: Ignored exception `ignored`, should not be called so #540. Thanks to XenoAmess.
* LANG-1528: StringUtils.replaceEachRepeatedly gives IllegalStateException #505. Thanks to Edwin Delgado H.
* LANG-1543: [JSON string for maps] ToStringBuilder.reflectionToString doesnt render nested maps correctly. Thanks to Swaraj Pal, Wander Costa, Gary Gregory.
*            Correct Javadocs of methods that use Validate.notNull() and replace some uses of Validate.isTrue() with Validate.notNull(). #525. Thanks to Isira Seneviratne.
* LANG-1539: Add allNull() and anyNull() methods to ObjectUtils. #522. Thanks to Isira Seneviratne.

Changes:
*            Refine test output for FastDateParserTest Thanks to Jin Xu.
* LANG-1549: CharSequenceUtils.lastIndexOf : remake it Thanks to Jin Xu.
*            remove encoding and docEncoding and use inherited values from commons-parent Thanks to XenoAmess.
*            Simplify null checks in Pair.hashCode() using Objects.hashCode(). #517. Thanks to Isira Seneviratne, Bruno P. Kinoshita.
*            Simplify null checks in Triple.hashCode() using Objects.hashCode(). #516. Thanks to Isira Seneviratne, Bruno P. Kinoshita.
*            Simplify some if statements in StringUtils. #521. Thanks to Isira Seneviratne, Bruno P. Kinoshita.
* LANG-1537: Simplify a null check in the private replaceEach() method of StringUtils. #514. Thanks to Isira Seneviratne, Bruno P. Kinoshita.
* LANG-1534: Replace some usages of the ternary operator with calls to Math.max() and Math.min() #512. Thanks to Isira Seneviratne, Bruno P. Kinoshita.
*            (Javadoc) Fix return tag for throwableOf*() methods #518. Thanks to Arend v. Reinersdorff, Bruno P. Kinoshita.
* LANG-1545: CharSequenceUtils.regionMatches is wrong dealing with Georgian. Thanks to XenoAmess, Gary Gregory.
* LANG-1550: Optimize ArrayUtils::isArrayIndexValid method. #551. Thanks to Edgar Asatryan.
* LANG-1561: Use List.sort instead of Collection.sort #546. Thanks to XenoAmess.
* LANG-1563: Use StandardCharsets.UTF_8 #548. Thanks to XenoAmess.
* LANG-1564: Use Collections.singletonList insteadof Arrays.asList when there be only one element. #549. Thanks to XenoAmess.
* LANG-1553: Change array style from `int a[]` to `int[] a` #537. Thanks to XenoAmess.
* LANG-1552: Change from addAll to constructors for some List #536. Thanks to XenoAmess.
* LANG-1558: Simplify if as some conditions are covered by others #543. Thanks to XenoAmess.
* LANG-1567: Fixed Javadocs for setTestRecursive() #556. Thanks to Miguel Mu�oz, Bruno P. Kinoshita, Gary Gregory.
* LANG-1542: ToStringBuilder.reflectionToString - Wrong JSON format when object has a List of Enum. Thanks to Tr?n Ng?c Khoa, Gary Gregory.
*            Make org.apache.commons.lang3.CharSequenceUtils.toCharArray(CharSequence) public.
*            org.apache.commons:commons-parent 50 -> 51.
*            org.junit-pioneer:junit-pioneer 0.5.4 -> 0.6.0.
*            org.junit.jupiter:junit-jupiter 5.6.0 -> 5.6.2.
*            com.github.spotbugs:spotbugs 4.0.0 -> 4.0.6.
*            com.puppycrawl.tools:checkstyle 8.29 -> 8.34.
*            commons.surefire.version 3.0.0-M4 -> 3.0.0-M5..


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

Have fun!
-Apache Commons Team

-----------------------------------------------------------------------------

Apache Commons Lang 3.10.0 Release Notes
----------------------------------------


INTRODUCTION:

This document contains the release notes for the 3.10 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any 
Java environment.

Lang 3.9 and onwards now targets Java 8, making use of features that arrived with Java 8.

For the advice on upgrading from 2.x to 3.x, see the following page: 

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

New features and bug fixes. Requires Java 8, supports Java 9, 10, 11.

Changes in this version include:

New features:
* LANG-1457: Add ExceptionUtils.throwableOfType(Throwable, Class) and friends.
* LANG-1458: Add EMPTY_ARRAY constants to classes in org.apache.commons.lang3.tuple.
* LANG-1461: Add null-safe StringUtils APIs to wrap String#getBytes([Charset|String]).
* LANG-1467: Add zero arg constructor for org.apache.commons.lang3.NotImplementedException.
* LANG-1470: Add ArrayUtils.addFirst() methods.
* LANG-1479: Add Range.fit(T) to fit a value into a range.
* LANG-1477: Added Functions.as*, and tests thereof, as suggested by Peter Verhas
* LANG-1485: Add getters for lhs and rhs objects in DiffResult #451. Thanks to nicolasbd.
* LANG-1486: Generify builder classes Diffable, DiffBuilder, and DiffResult #452. Thanks to Gary Gregory.
* LANG-1487: Add ClassLoaderUtils with toString() implementations #453. Thanks to Gary Gregory.
* LANG-1489: Add null-safe APIs as StringUtils.toRootLowerCase(String) and StringUtils.toRootUpperCase(String) #456. Thanks to Gary Gregory.
* LANG-1494: Add org.apache.commons.lang3.time.Calendars. Thanks to Gary Gregory.
* LANG-1495: Add EnumUtils getEnum() methods with default values #475. Thanks to Cheong Voon Leong.
* LANG-1177: Added indexesOf methods and simplified removeAllOccurences #471. Thanks to Liel Fridman.
* LANG-1498: Add support of lambda value evaluation for defaulting methods #416. Thanks to Lysergid, Gary Gregory.
* LANG-1503: Add factory methods to Pair classes with Map.Entry input. #454. Thanks to XenoAmess, Gary Gregory.
* LANG-1505: Add StopWatch convenience APIs to format times and create a simple instance. Thanks to Gary Gregory.
* LANG-1506: Allow a StopWatch to carry an optional message. Thanks to Gary Gregory.
* LANG-1507: Add ComparableUtils #398. Thanks to Sam Kruglov, Mark Dacek, Marc Magon, Pascal Schumacher, Rob Tompkins, Bruno P. Kinoshita, Amey Jadiye, Gary Gregory.
* LANG-1508: Add org.apache.commons.lang3.SystemUtils.getUserName(). Thanks to Gary Gregory.
* LANG-1509: Add ObjectToStringComparator. #483. Thanks to Gary Gregory.
* LANG-1510: Add org.apache.commons.lang3.arch.Processor.Arch.getLabel(). Thanks to Gary Gregory.
* LANG-1512: Add IS_JAVA_14 and IS_JAVA_15 to org.apache.commons.lang3.SystemUtils. Thanks to Gary Gregory.
* LANG-1513: ObjectUtils: Get first non-null supplier value. Thanks to Bernhard Bonigl, Gary Gregory.
*            Added the Streams class, and Functions.stream() as an accessor thereof.

Fixed Bugs:
* LANG-1514: Make test more stable by wrapping assertions in hashset. Thanks to contextshuffling.
* LANG-1450: Generate Javadoc jar on build.
* LANG-1460: Trivial: year of release for 3.9 says 2018, should be 2019 Thanks to Larry West.
* LANG-1476: Use synchronize on a set created with Collections.synchronizedSet before iterating Thanks to emopers.
* LANG-1475: StringUtils.unwrap incorrect throw StringIndexOutOfBoundsException. Thanks to stzx.
* LANG-1406: StringIndexOutOfBoundsException in StringUtils.replaceIgnoreCase #423. Thanks to geratorres.
* LANG-1453: StringUtils.removeIgnoreCase("?a", "a") throws IndexOutOfBoundsException #423. Thanks to geratorres.
* LANG-1426: Corrected usage examples in Javadocs #458. Thanks to Brower, Mikko Maunu, Suraj Gautam.
* LANG-1463: StringUtils abbreviate returns String of length greater than maxWidth #477. Thanks to bbeckercscc, Gary Gregory.
* LANG-1500: Test may fail due to a different order of fields returned by reflection api #480. Thanks to contextshuffling.
* LANG-1501: Sort fields in ReflectionToStringBuilder for deterministic order #481. Thanks to contextshuffling.
* LANG-1433: MethodUtils will throw a NPE if invokeMethod() is called for a var-args method #407. Thanks to Christian Franzen.
* LANG-1518: MethodUtils.getAnnotation() with searchSupers = true does not work if super is generic #494. Thanks to Michele Preti, Bruno P. Kinoshita, Gary Gregory.

Changes:
* LANG-1437: Remove redundant if statements in join methods #411. Thanks to Andrei Troie.
*            commons.japicmp.version 0.13.1 -> 0.14.1.
*            junit-jupiter 5.5.0 -> 5.5.1.
*            junit-jupiter 5.5.1 -> 5.5.2.
*            Improve Javadoc based on the discussion of the GitHub PR #459. Thanks to Jonathan Leitschuh, Bruno P. Kinoshita, Rob Tompkins, Gary Gregory.
*            maven-checkstyle-plugin 3.0.0 -> 3.1.0.
* LANG-696:  Update documentation related to the issue LANG-696 #449. Thanks to Peter Verhas.
*            AnnotationUtils little cleanup #467. Thanks to Peter Verhas.
*            Update test dependency: org.easymock:easymock 4.0.2 -> 4.1. Thanks to Gary Gregory.
*            Update test dependency: org.hamcrest:hamcrest 2.1 -> 2.2. Thanks to Gary Gregory.
*            Update test dependency: org.junit-pioneer:junit-pioneer 0.3.0 -> 0.4.2. Thanks to Gary Gregory.
*            Update build dependency: com.puppycrawl.tools:checkstyle 8.18 -> 8.27. Thanks to Gary Gregory.
*            Update POM parent: org.apache.commons:commons-parent 48 -> 50. Thanks to Gary Gregory.
*            BooleanUtils Javadoc #469. Thanks to Peter Verhas.
*            Functions Javadoc #466. Thanks to Peter Verhas.
*            org.easymock:easymock 4.1 -> 4.2. Thanks to Gary Gregory.
*            org.junit-pioneer:junit-pioneer 0.4.2 -> 0.5.4. Thanks to Gary Gregory.
*            org.junit.jupiter:junit-jupiter 5.5.2 -> 5.6.0. Thanks to Gary Gregory.
*            Use Javadoc {@code} instead of pre tags. #490. Thanks to Peter Verhas.
*            ExceptionUtilsTest to 100% #486. Thanks to Peter Verhas.
*            Reuse own code in Functions.java #493. Thanks to Peter Verhas.
* LANG-1523: Avoid unnecessary allocation in StringUtils.wrapIfMissing. #496. Thanks to Edgar Asatryan, Bruno P. Kinoshita, Gary Gregory.
* LANG-1525: Internally use Validate.notNull(foo, ...) instead of Validate.isTrue(foo != null, ...). Thanks to Edgar Asatryan, Bruno P. Kinoshita, Gary Gregory.
* LANG-1526: Add 1 and 0 in toBooleanObject(final String str) #502. Thanks to Dominik Schramm.
* LANG-1527: Remove an redundant argument check in NumberUtils #504. Thanks to Pengyu Nie.
* LANG-1529: Deprecate org.apache.commons.lang3.ArrayUtils.removeAllOccurences(*) for org.apache.commons.lang3.ArrayUtils.removeAllOccurrences(*). Thanks to Gary Gregory, BillCindy, Bruno P. Kinoshita.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi

-----------------------------------------------------------------------------

Apache Commons Lang 3.9 Release Notes
-------------------------------------


INTRODUCTION:

This document contains the release notes for the 3.9 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any 
Java environment.

Lang 3.9 and onwards now targets Java 8, making use of features that arrived with Java 8.

For the advice on upgrading from 2.x to 3.x, see the following page: 

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

New features and bug fixes. Requires Java 8, supports Java 9, 10, 11

Changes in this version include:

New features:
* LANG-1442: Javadoc pointing to Commons RNG.
*            Adding the Functions class.
* LANG-1411: Add isEmpty method to ObjectUtils Thanks to Alexander Tsvetkov.
* LANG-1422: Add null-safe StringUtils.valueOf(char[]) to delegate to String.valueOf(char[])
* LANG-1427: Add API org.apache.commons.lang3.SystemUtils.isJavaVersionAtMost(JavaVersion)


Changes:
* LANG-1416: Add more SystemUtils.IS_JAVA_XX variants.
* LANG-1416: Update to JUnit 5
* LANG-1417: Add @FunctionalInterface to ThreadPredicate and ThreadGroupPredicate
* LANG-1415: Update Java Language requirement to 1.8
* LANG-1436: Consolidate the StringUtils equals and equalsIgnoreCase Javadoc and implementation
*            (doc) Fix javadoc for 'startIndex' parameter of StringUtils.join() methods. GitHub PR #412. Thanks to Andrei Troie aft90.


Historical list of changes: https://commons.apache.org/proper/commons-lang/changes-report.html

For complete information on Apache Commons Lang, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Lang website:

https://commons.apache.org/proper/commons-lang/

-----------------------------------------------------------------------------

Apache Commons Lang 3.8.1 Release Notes
----------------------------------------


INTRODUCTION:

This document contains the release notes for the 3.8.1 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any
Java environment.

Lang 3.0 and onwards now targets Java 7.0, making use of features that arrived with Java 7.0.

For the advice on upgrading from 2.x to 3.x, see the following page:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

This release is a bugfix for Restoring Bundle-SymbolicName in the MANIFEST.mf file.

Changes in this version include:


Fixed Bugs:
* LANG-1419: Restore BundleSymbolicName for OSGi

-----------------------------------------------------------------------------

Apache Commons Lang 3.8 Release Notes
-------------------------------------


INTRODUCTION:

This document contains the release notes for the 3.8 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any
Java environment.

Lang 3.0 and onwards now targets Java 7.0, making use of features that arrived with Java 7.0.

For the advice on upgrading from 2.x to 3.x, see the following page:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

New features and bug fixes. Requires Java 7, supports Java 8, 9, 10.

Changes in this version include:

New features:
* LANG-1352: EnumUtils.getEnumIgnoreCase and isValidEnumIgnoreCase methods added Thanks to Ruslan Sibgatullin.
* LANG-1372: Add ToStringSummary annotation Thanks to S�rgio Ozaki.
* LANG-1356: Add bypass option for classes to recursive and reflective EqualsBuilder Thanks to Yathos UG.
* LANG-1391: Improve Javadoc for StringUtils.isAnyEmpty(null) Thanks to Sauro Matulli, Oleg Chubaryov.
* LANG-1393: Add API SystemUtils.String getEnvironmentVariable(final String name, final String defaultValue) Thanks to Gary Gregory.
* LANG-1394: org.apache.commons.lang3.SystemUtils should not write to System.err. Thanks to Sebb, Gary Gregory.
* LANG-1238: Add RegexUtils class instead of overloading methods in StringUtils that take a regex to take precompiled Pattern. Thanks to Christopher Cordeiro, Gary Gregory, Bruno P. Kinoshita, Oleg Chubaryov.
* LANG-1390: StringUtils.join() with support for List<?> with configurable start/end indices. Thanks to Jochen Schalanda.
* LANG-1392: Methods for getting first non empty or non blank value Thanks to Jeff Nelson.
* LANG-1408: Rounding utilities for converting to BigDecimal

Fixed Bugs:
* LANG-1380: FastDateParser too strict on abbreviated short month symbols Thanks to Markus Jelsma.
* LANG-1396: JsonToStringStyle does not escape string names
* LANG-1395: JsonToStringStyle does not escape double quote in a string value Thanks to Jim Gan.
* LANG-1384: New Java version ("11") must be handled Thanks to Ian Young.
* LANG-1364: ExceptionUtils#getRootCause(Throwable t) should return t if no lower level cause exists Thanks to Zheng Xie.
* LANG-1060: NumberUtils.isNumber assumes number starting with Zero Thanks to Piotr Kosmala.
* LANG-1375: defaultString(final String str) in StringUtils to reuse defaultString(final String str, final String defaultStr) Thanks to Jerry Zhao.
* LANG-1374: Parsing Json Array failed Thanks to Jaswanth Bala.
* LANG-1371: Fix TypeUtils#parameterize to work correctly with narrower-typed array Thanks to Dmitry Ovchinnikov.
* LANG-1370: Fix EventCountCircuitBreaker increment batch Thanks to Andre Dieb.
* LANG-1385: NumberUtils.createNumber() throws StringIndexOutOfBoundsException instead of NumberFormatException Thanks to Rohan Padhye.
* LANG-1397: WordUtils.wrap throws StringIndexOutOfBoundsException when wrapLength is Integer.MAX_VALUE. Thanks to Takanobu Asanuma.
* LANG-1401: Typo in JavaDoc for lastIndexOf Thanks to Roman Golyshev, Alex Mamedov.

Changes:
* LANG-1367: ObjectUtils.identityToString(Object) and friends should allocate builders and buffers with a size Thanks to Gary Gregory.
* LANG-1405: Remove checks for java versions below the minimum supported one Thanks to Lars Grefer.
* LANG-1402: Null/index safe get methods for ArrayUtils Thanks to Mark Dacek.

-----------------------------------------------------------------------------

Apache Commons Lang 3.7 Release Notes
----------------------------------------

INTRODUCTION:

This document contains the release notes for the 3.7 version of Apache Commons Lang.
Commons Lang is a set of utility functions and reusable components that should be of use in any
Java environment.

Lang 3.0 and onwards now targets Java 5.0, making use of features that arrived with Java 5.0 such as generics,
variable arguments, autoboxing, concurrency and formatted output.

For the advice on upgrading from 2.x to 3.x, see the following page:

    https://commons.apache.org/lang/article3_0.html

Apache Commons Lang, a package of Java utility classes for the
classes that are in java.lang's hierarchy, or are considered to be so
standard as to justify existence in java.lang.

New features and bug fixes. Requires Java 7, supports Java 8, 9, 10.

Changes in this version include:

New features:
* LANG-1355: TimeZone.getTimeZone() in FastDateParser causes resource contention (PR #296.) Thanks to Chas Honton.
* LANG-1360: Add methods to ObjectUtils to get various forms of class names in a null-safe manner Thanks to Gary Gregory.

Fixed Bugs:
* LANG-1362: Fix tests DateUtilsTest for Java 9 with en_GB locale Thanks to Stephen Colebourne.
* LANG-1365: Fix NullPointerException in isJavaVersionAtLeast on Java 10, add SystemUtils.IS_JAVA_10, add JavaVersion.JAVA_10 Thanks to Gary Gregory.
* LANG-1348: StackOverflowError on TypeUtils.toString(...) for a generic return type of Enum.valueOf Thanks to mbusso.
* LANG-1350: ConstructorUtils.invokeConstructor(Class, Object...) regression Thanks to Brett Kail.
* LANG-1349: EqualsBuilder#isRegistered: swappedPair construction bug Thanks to Naman Nigam.
* LANG-1357: org.apache.commons.lang3.time.FastDateParser should use toUpperCase(Locale) Thanks to BruceKuiLiu.

Changes:
* LANG-1358: Improve StringUtils#replace throughput Thanks to Stephane Landelle.
* LANG-1346: Remove deprecation from RandomStringUtils
* LANG-1361: ExceptionUtils.getThrowableList() is using deprecated ExceptionUtils.getCause() Thanks to Ana.


-----------------------------------------------------------------------------

Apache Commons Lang 3.6 Release Notes
----------------------------------------


INTRODUCTION:

This document contains the release notes for the 3.6 version of
Apache Commons Lang as well as a history all changes in the Commons Lang 3.x
release line. Commons Lang is a set of utility functions and reusable
components that should be of use in any Java environment. Commons Lang 3.6 at
least requires Java 7.0. Note that this has changed from Commons Lang 3.5, which
only required Java 1.6.

For the advice on upgrading from 2.x to 3.x, see the following page:

    https://commons.apache.org/lang/article3_0.html

HIGHLIGHTS
==========

Some of the highlights in this release include:

o The class org.apache.commons.lang3.concurrent.Memoizer is an implementation
    of the Memoizer pattern as shown in
    Goetz, Brian et al. (2006) - Java Concurrency in Practice, p. 108.
o The class org.apache.commons.lang3.ArchUtils has been added. ArchUtils is
    a utility class for the "os.arch" system property.

DEPRECATIONS
============

The Apache Commons Community has recently set up the Commons Text component
as a home for algorithms working on strings. For this reason most of the string
focused functionality in Commons Lang has been deprecated and moved to
Commons Text. This includes:

o All classes in the org.apache.commons.lang3.text and the
    org.apache.commons.lang3.text.translate packages
o org.apache.commons.lang3.StringEscapeUtils
o org.apache.commons.lang3.RandomStringUtils
o The methods org.apache.commons.lang3.StringUtils.getJaroWinklerDistance and
    org.apache.commons.lang3.StringUtils.getLevenshteinDistance

For more information see the Commons Text website:

    https://commons.apache.org/text

The class org.apache.commons.lang3.CharEncoding has been deprecated in favor of
java.nio.charset.StandardCharsets.

The following methods have been deprecated in
org.apache.commons.lang3.ArrayUtils in favor of the corresponding insert
methods. Note that the handling for null inputs differs between add and insert.

o add(boolean[], int, boolean) -> insert(int, boolean[], boolean...)
o add(byte[], int, boolean)    -> insert(int, byte[], byte...)
o add(char[], int, boolean)    -> insert(int, char[], char...)
o add(double[], int, boolean)  -> insert(int, double[], double...)
o add(float[], int, boolean)   -> insert(int, float[], float...)
o add(int[], int, boolean)     -> insert(int, int[], int...)
o add(long[], int, boolean)    -> insert(int, long[], long...)
o add(short[], int, boolean)   -> insert(int, short[], short...)
o add(T[], int, boolean)       -> insert(int, T[], T...)


COMPATIBILITY WITH JAVA 9
==================

The MANIFEST.MF now contains an additional entry:

  Automatic-Module-Name: org.apache.commons.lang3

This should make it possible to use Commons Lang 3.6 as a module in the Java 9
module system. For more information see the corresponding issue and the
referenced mailing list discussions:

    https://issues.apache.org/jira/browse/LANG-1338

The build problems present in the 3.5 release have been resolved. Building
Commons Lang 3.6 should work out of the box with the latest Java 9 EA build.
Please report any Java 9 related issues at:

    https://issues.apache.org/jira/browse/LANG

NEW FEATURES
============

* LANG-1336: Add NUL Byte To CharUtils. Thanks to Beluga Behr.
* LANG-1304: Add method in StringUtils to determine if string contains both
             mixed cased characters. Thanks to Andy Klimczak.
* LANG-1325: Increase test coverage of ToStringBuilder class to 100%.
             Thanks to Arshad Basha.
* LANG-1307: Add a method in StringUtils to extract only digits out of input
             string. Thanks to Arshad Basha.
* LANG-1256: Add JMH maven dependencies. Thanks to C0rWin.
* LANG-1167: Add null filter to ReflectionToStringBuilder.
             Thanks to Mark Dacek.
* LANG-1299: Add method for converting string to an array of code points.
* LANG-660:  Add methods to insert arrays into arrays at an index.
* LANG-1034: Add support for recursive comparison to
             EqualsBuilder#reflectionEquals. Thanks to Yathos UG.
* LANG-1067: Add a reflection-based variant of DiffBuilder.
* LANG-740:  Implementation of a Memoizer. Thanks to James Sawle.
* LANG-1258: Add ArrayUtils#toStringArray method.
             Thanks to IG, Grzegorz Ro?niecki.
* LANG-1160: StringUtils#abbreviate should support 'custom ellipses' parameter.
* LANG-1293: Add StringUtils#isAllEmpty and #isAllBlank methods.
             Thanks to Pierre Templier, Martin Tarjanyi.
* LANG-1313: Add ArchUtils - An utility class for the "os.arch" system property.
             Thanks to Tomschi.
* LANG-1272: Add shuffle methods to ArrayUtils.
* LANG-1317: Add MethodUtils#findAnnotation and extend
             MethodUtils#getMethodsWithAnnotation for non-public, super-class
             and interface methods. Thanks to Yasser Zamani.
* LANG-1331: Add ImmutablePair.nullPair().
* LANG-1332: Add ImmutableTriple.nullTriple().

FIXED BUGS
==========

* LANG-1337: Fix test failures in IBM JDK 8 for ToStringBuilderTest.
* LANG-1319: MultilineRecursiveToStringStyle StackOverflowError when object is
             an array.
* LANG-1320: LocaleUtils#toLocale does not support language followed by UN M.49
             numeric-3 area code followed by variant.
* LANG-1300: Clarify or improve behavior of int-based indexOf methods in
             StringUtils. Thanks to Mark Dacek.
* LANG-1286: RandomStringUtils random method can overflow and return characters
             outside of specified range.
* LANG-1292: WordUtils.wrap throws StringIndexOutOfBoundsException.
* LANG-1287: RandomStringUtils#random can enter infinite loop if end parameter
             is to small. Thanks to Ivan Morozov.
* LANG-1285: NullPointerException in FastDateParser$TimeZoneStrategy.
             Thanks to Francesco Chicchiricc�.
* LANG-1281: Javadoc of StringUtils.ordinalIndexOf is contradictory.
             Thanks to Andreas Lundblad.
* LANG-1188: StringUtils#join(T...): warning: [unchecked] Possible heap
             pollution from parameterized vararg type T.
* LANG-1144: Multiple calls of
             org.apache.commons.lang3.concurrent.LazyInitializer.initialize()
             are possible. Thanks to Waldemar Maier, Gary Gregory.
* LANG-1276: StrBuilder#replaceAll ArrayIndexOutOfBoundsException.
             Thanks to Andy Klimczak.
* LANG-1278: BooleanUtils javadoc issues. Thanks to Duke Yin.
* LANG-1070: ArrayUtils#add confusing example in javadoc.
             Thanks to Paul Pogonyshev.
* LANG-1271: StringUtils#isAnyEmpty and #isAnyBlank should return false for an
             empty array. Thanks to Pierre Templier.
* LANG-1155: Add StringUtils#unwrap. Thanks to Saif Asif, Thiago Andrade.
* LANG-1311: TypeUtils.toString() doesn't handle primitive and Object arrays
             correctly. Thanks to Aaron Digulla.
* LANG-1312: LocaleUtils#toLocale does not support language followed by UN M.49
             numeric-3 area code.
* LANG-1265: Build failures when building with Java 9 EA.
* LANG-1314: javadoc creation broken with Java 8. Thanks to Allon Murienik.
* LANG-1310: MethodUtils.invokeMethod throws ArrayStoreException if using
             varargs arguments and smaller types than the method defines.
             Thanks to Don Jeba.

CHANGES
=======

* LANG-1338: Add Automatic-Module-Name MANIFEST entry for Java 9
             compatibility.
* LANG-1334: Deprecate CharEncoding in favour of
             java.nio.charset.StandardCharsets.
* LANG-1110: Implement HashSetvBitSetTest using JMH.
             Thanks to Bruno P. Kinoshita.
* LANG-1290: Increase test coverage of org.apache.commons.lang3.ArrayUtils.
             Thanks to Andrii Abramov.
* LANG-1274: StrSubstitutor should state its thread safety.
* LANG-1277: StringUtils#getLevenshteinDistance reduce memory consumption.
             Thanks to yufcuy.
* LANG-1279: Update Java requirement from Java 6 to 7.
* LANG-1143: StringUtils should use toXxxxCase(int) rather than
             toXxxxCase(char). Thanks to sebb.
* LANG-1297: Add SystemUtils.getHostName() API.
* LANG-1301: Moving apache-rat-plugin configuration into pluginManagement.
             Thanks to Karl Heinz Marbaise.
* LANG-1316: Deprecate classes/methods moved to commons-text.

-----------------------------------------------------------------------------

Apache Commons Lang 3.5 Release Notes
----------------------------------------


HIGHLIGHTS
==========

Some of the highlights in this release include:

o Added Java 9 detection to org.apache.commons.lang3.SystemUtils.
o Support for shifting and swapping elements in
    org.apache.commons.lang3.ArrayUtils.
o New methods for generating random strings from different character classes
    including alphabetic, alpha-numeric and ASCII added to
    org.apache.commons.lang3.RandomStringUtils.
o Numerous extensions to org.apache.commons.lang3.StringUtils including
    null safe compare variants, more remove and replace variants, rotation and
    truncation.
o Added org.apache.commons.lang3.ThreadUtils - a utility class to work with
    instances of java.lang.Thread and java.lang.ThreadGroup.
o Added annotations @EqualsExclude, @HashCodeExclude and @ToStringExclude to
    mark fields which should be ignored by the reflective builders in the
    org.apache.commons.lang3.builder package.
o Support for various modify and retrieve value use cases added to the classes
    in org.apache.commons.lang3.mutable.

COMPATIBILITY
=============

Apache Commons Lang 3.5 is binary compatible with the 3.4 release. Users
should not experience any problems when upgrading from 3.4 to 3.5.

There has been an addition to the org.apache.commons.lang3.time.DatePrinter
interface:

o Added method 'public boolean parse(java.lang.String, java.text.ParsePosition,
    java.util.Calendar)'
o Added method 'public java.lang.Appendable format(long, java.lang.Appendable)'
o Added method 'public java.lang.Appendable format(java.util.Date,
    java.lang.Appendable)'
o Added method 'public java.lang.Appendable format(java.util.Calendar,
    java.lang.Appendable)'

For this reason 3.5 is not strictly source compatible to 3.4. Since the
DatePrinter interface is not meant to be implemented by clients, this
change it not considered to cause any problems.

JAVA 9 SUPPORT
==============

Java 9 introduces a new version-string scheme. Details of this new scheme are
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
    deprecated enum constant JAVA_1_9
    introduced enum constant JAVA_9

o org.apache.commons.lang3.SystemUtils
    deprecated constant IS_JAVA_1_9
    introduced constant IS_JAVA_9

For more information see LANG-1197
(https://issues.apache.org/jira/browse/LANG-1197). All other APIs are expected
to work with Java 9.

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 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':

    mvn -Djava.locale.providers=JRE clean install

We are currently investigating ways to support building on Java 9 without
further configuration. For more information see:
https://issues.apache.org/jira/browse/LANG-1265


NEW FEATURES
==============

* LANG-1275: Added a tryAcquire() method to TimedSemaphore.
* LANG-1255: Add DateUtils.toCalendar(Date, TimeZone). Thanks to Kaiyuan Wang.
* LANG-1023: Add WordUtils.wrap overload with customizable breakable character.
             Thanks to Marko Bekhta.
* LANG-787:  Add method removeIgnoreCase(String, String) to StringUtils. Thanks
             to Gokul Nanthakumar C.
* LANG-1224: Extend RandomStringUtils with methods that generate strings
             between a min and max length. Thanks to Caleb Cushing.
* LANG-1257: Add APIs StringUtils.wrapIfMissing(String, char|String). Thanks to
             Gary Gregory.
* LANG-1253: Add RandomUtils#nextBoolean() method. Thanks to adilek.
* LANG-1085: Add a circuit breaker implementation. Thanks to Oliver Heger and
             Bruno P. Kinoshita.
* LANG-1013: Add StringUtils.truncate(). Thanks to Thiago Andrade.
* LANG-1195: Enhance MethodUtils to allow invocation of private methods. Thanks
             to Derek C. Ashmore.
* LANG-1189: Add getAndIncrement/getAndDecrement/getAndAdd/incrementAndGet/
             decrementAndGet/addAndGet in Mutable* classes. Thanks to
             Haiyang Li and Matthew Bartenschlag.
* LANG-1225: Add RandomStringUtils#randomGraph and #randomPrint which match
             corresponding regular expression class. Thanks to Caleb Cushing.
* LANG-1223: Add StopWatch#getTime(TimeUnit). Thanks to Nick Manley.
* LANG-781:  Add methods to ObjectUtils class to check for null elements in the
             array. Thanks to Krzysztof Wolny.
* LANG-1228: Prefer Throwable.getCause() in ExceptionUtils.getCause().
             Thanks to Brad Hess.
* LANG-1233: DiffBuilder add method to allow appending from a DiffResult.
             Thanks to Nick Manley.
* LANG-1168: Add SystemUtils.IS_OS_WINDOWS_10 property.
             Thanks to Pascal Schumacher.
* LANG-1115: Add support for varargs in ConstructorUtils, MemberUtils, and
             MethodUtils. Thanks to Jim Lloyd and Joe Ferner.
* LANG-1134: Add methods to check numbers against NaN and infinite to
             Validate. Thanks to Alan Smithee.
* LANG-1220: Add tests for missed branches in DateUtils.
             Thanks to Casey Scarborough.
* LANG-1146: z/OS identification in SystemUtils.
             Thanks to Gabor Liptak.
* LANG-1192: FastDateFormat support of the week-year component (uppercase 'Y').
             Thanks to Dominik Stadler.
* LANG-1169: Add StringUtils methods to compare a string to multiple strings.
             Thanks to Rafal Glowinski, Robert Parr and Arman Sharif.
* LANG-1185: Add remove by regular expression methods in StringUtils.
* LANG-1139: Add replace by regular expression methods in StringUtils.
* LANG-1171: Add compare methods in StringUtils.
* LANG-1174: Add sugar to RandomUtils. Thanks to Punkratz312.
* LANG-1154: FastDateFormat APIs that use a StringBuilder. Thanks to
             Gary Gregory.
* LANG-1149: Ability to throw checked exceptions without declaring them. Thanks
             to Gregory Zak.
* LANG-1153: Implement ParsePosition api for FastDateParser.
* LANG-1137: Add check for duplicate event listener in EventListenerSupport.
             Thanks to Matthew Aguirre.
* LANG-1135: Add method containsAllWords to WordUtils. Thanks to
             Eduardo Martins.
* LANG-1132: ReflectionToStringBuilder doesn't throw IllegalArgumentException
             when the constructor's object param is null. Thanks to Jack Tan.
* LANG-701:  StringUtils join with var args. Thanks to James Sawle.
* LANG-1105: Add ThreadUtils - A utility class which provides helper methods
             related to java.lang.Thread  Issue: LANG-1105. Thanks to
             Hendrik Saly.
* LANG-1031: Add annotations to exclude fields from ReflectionEqualsBuilder,
             ReflectionToStringBuilder and ReflectionHashCodeBuilder. Thanks
             to Felipe Adorno.
* LANG-1127: Use JUnit rules to set and reset the default Locale and TimeZone.
* LANG-1119: Add rotate(string, int) method to StringUtils. Thanks to
             Loic Guibert.
* LANG-1099: Add swap and shift operations for arrays to ArrayUtils. Thanks to
             Adrian Ber.
* LANG-1050: Change nullToEmpty methods to generics. Thanks to James Sawle.
* LANG-1074: Add a method to ArrayUtils for removing all occurrences of a given
             element  Issue: LANG-1074. Thanks to Haiyang Li.

FIXED BUGS
============

* LANG-1261: ArrayUtils.contains returns false for instances of subtypes.
* LANG-1252: Rename NumberUtils.isNumber, isCreatable to better reflect
             createNumber. Also, accommodated for "+" symbol as prefix in
             isCreatable and isNumber. Thanks to Rob Tompkins.
* LANG-1230: Remove unnecessary synchronization from registry lookup in
             EqualsBuilder and HashCodeBuilder. Thanks to Philippe Marschall.
* LANG-1214: Handle "void" in ClassUtils.getClass(). Thanks to Henry Tung.
* LANG-1250: SerializationUtils#deserialize has unnecessary code and a comment
             for that. Thanks to Glease Wang.
* LANG-1190: TypeUtils.isAssignable throws NullPointerException when fromType
             has type variables and toType generic superclass specifies type
             variable. Thanks to Pascal Schumacher.
* LANG-1226: StringUtils#normalizeSpace does not trim the string anymore.
             Thanks to Pascal Schumacher.
* LANG-1251: SerializationUtils.ClassLoaderAwareObjectInputStream should use
             static initializer to initialize primitiveTypes map. Thanks to
             Takuya Ueshin.
* LANG-1248: FastDatePrinter Memory allocation regression. Thanks to
             Benoit Wiart.
* LANG-1018: Fix precision loss on NumberUtils.createNumber(String). Thanks to
             Nick Manley.
* LANG-1199: Fix implementation of StringUtils.getJaroWinklerDistance(). Thanks
             to M. Steiger.
* LANG-1244: Fix dead links in StringUtils.getLevenshteinDistance() javadoc.
             Thanks to jjbankert.
* LANG-1242: "\u2284":"?" mapping missing from
             EntityArrays#HTML40_EXTENDED_ESCAPE. Thanks to Neal Stewart.
* LANG-901:  StringUtils#startsWithAny/endsWithAny is case sensitive -
             documented as case insensitive. Thanks to Matthew Bartenschlag.
* LANG-1232: DiffBuilder: Add null check on fieldName when appending Object or
             Object[]. Thanks to Nick Manley.
* LANG-1178: ArrayUtils.removeAll(Object array, int... indices) should do the
             clone, not its callers. Thanks to Henri Yandell.
* LANG-1120: StringUtils.stripAccents should remove accents from "?" and "?".
             Thanks to kaching88.
* LANG-1205: NumberUtils.createNumber() behaves inconsistently with
             NumberUtils.isNumber(). Thanks to pbrose.
* LANG-1222: Fix for incorrect comment on StringUtils.containsIgnoreCase
             method. Thanks to Adam J.
* LANG-1221: Fix typo on appendIfMissing javadoc. Thanks to Pierre Templier.
* LANG-1202: parseDateStrictly doesn't pass specified locale. Thanks to
             Markus Jelsma.
* LANG-1219: FastDateFormat doesn't respect summer daylight in some localized
             strings. Thanks to Jarek.
* LANG-1175: Remove Ant-based build.
* LANG-1194: Limit max heap memory for consistent Travis CI build.
* LANG-1186: Fix NullPointerException in FastDateParser$TimeZoneStrategy.
             Thanks to NickManley.
* LANG-1193: ordinalIndexOf("abc", "ab", 1) gives incorrect answer of -1
             (correct answer should be 0); revert fix for LANG-1077. Thanks to
             Qin Li.
* LANG-1002: Several predefined ISO FastDateFormats in DateFormatUtils are
             incorrect. Thanks to Michael Osipov.
* LANG-1152: StringIndexOutOfBoundsException or field over-write for large year
             fields in FastDateParser. Thanks to Pas Filip.
* LANG-1141: StrLookup.systemPropertiesLookup() no longer reacts on changes on
             system properties.
* LANG-1147: EnumUtils *BitVector issue with more than 32 values Enum. Thanks
             to Loic Guibert.
* LANG-1059: Capitalize javadoc is incorrect. Thanks to Colin Casey.
* LANG-1122: Inconsistent behavior of swap for malformed inputs. Thanks to
             Adrian Ber.
* LANG-1130: Fix critical issues reported by SonarQube.
* LANG-1131: StrBuilder.equals(StrBuilder) doesn't check for null inputs.
* LANG-1128: JsonToStringStyle doesn't handle chars and objects correctly.
             Thanks to Jack Tan.
* LANG-1126: DateFormatUtilsTest.testSMTP depends on the default Locale.
* LANG-1123: Unit test FastDatePrinterTimeZonesTest needs a timezone set.
             Thanks to Christian P. Momon.
* LANG-916:  DateFormatUtils.format does not correctly change Calendar
             TimeZone in certain situations. Thanks to Christian P. Momon.
* LANG-1116: DateUtilsTest.testLang530 fails for some timezones. Thanks to
             Aaron Sheldon.
* LANG-1114: TypeUtils.ParameterizedType#equals doesn't work with wildcard
             types. Thanks to Andy Coates.
* LANG-1118: StringUtils.repeat('z', -1) throws NegativeArraySizeException.
             Thanks to Loic Guibert.
* LANG-1111: Fix FindBugs warnings in DurationFormatUtils.
* LANG-1162: StringUtils#equals fails with Index OOBE on non-Strings with
             identical leading prefix..
* LANG-1163: There are no tests for CharSequenceUtils.regionMatches.
* LANG-1200: Fix Javadoc of StringUtils.ordinalIndexOf. Thanks to BarkZhang.
* LANG-1191: Incorrect Javadoc
             StringUtils.containsAny(CharSequence, CharSequence...). Thanks to
             qed, Brent Worden and Gary Gregory.

CHANGES
=========
* LANG-1197: Prepare Java 9 detection.
* LANG-1262: CompareToBuilder.append(Object, Object, Comparator) method is too
             big to be inlined. Thanks to Ruslan Cheremin.
* LANG-1259: Javadoc for ArrayUtils.isNotEmpty() is slightly misleading. Thanks
             to Dominik Stadler.
* LANG-1247: FastDatePrinter generates extra Date objects. Thanks to
             Benoit Wiart.
* LANG-1229: HashCodeBuilder.append(Object,Object) is too big to be inlined,
             which prevents whole builder to be scalarized. Thanks to
             Ruslan Cheremin.
* LANG-1243: Simplify ArrayUtils removeElements by using new decrementAndGet()
             method.
* LANG-1240: Optimize BitField constructor implementation. Thanks to zhanhb.
* LANG-1206: Improve CharSetUtils.squeeze() performance. Thanks to
             Mohammed Alfallaj.
* LANG-1176: Improve ArrayUtils removeElements time complexity to O(n). Thanks
             to Jeffery Yuan.
* LANG-1234: getLevenshteinDistance with a threshold: optimize implementation
             if the strings lengths differ more than the threshold. Thanks to
             Jonatan J�nsson.
* LANG-1151: Performance improvements for NumberUtils.isParsable. Thanks to
             Juan Pablo Santos Rodr�guez.
* LANG-1218: EqualsBuilder.append(Object,Object) is too big to be inlined,
             which prevents whole builder to be scalarized. Thanks to
             Ruslan Cheremin.
* LANG-1210: StringUtils#startsWithAny has error in Javadoc. Thanks to
             Matthias Niehoff.
* LANG-1208: StrSubstitutor can preserve escapes. Thanks to Samuel Karp.
* LANG-1182: Clarify Javadoc of StringUtils.containsAny(). Thanks to
             Larry West and Pascal Schumacher.
* LANG-1183: Making replacePattern/removePattern methods null safe in
             StringUtils.
* LANG-1057: Replace StringBuilder with String concatenation for better
             optimization. Thanks to Ot�vio Santana.
* LANG-1075: Deprecate SystemUtils.FILE_SEPARATOR and
             SystemUtils.PATH_SEPARATOR.
* LANG-979:  TypeUtils.parameterizeWithOwner - wrong format descriptor for
             "invalid number of type parameters". Thanks to Bruno P. Kinoshita.
* LANG-1112: MultilineRecursiveToStringStyle largely unusable due to being
             package-private.
* LANG-1058: StringUtils.uncapitalize performance improvement. Thanks to
             Leo Wang.
* LANG-1069: CharSet.getInstance documentation does not clearly explain how
             to include negation character in set. Thanks to Arno Noordover.
* LANG-1107: Fix parsing edge cases in FastDateParser.
* LANG-1273: Added new property IS_OS_MAC_OSX_EL_CAPITAN in SystemUtils. Thanks
             to Jake Wang.

-----------------------------------------------------------------------------

Apache Commons Lang 3.4 Release Notes
-------------------------------------

COMPATIBILITY
=============

Commons Lang 3.4 is fully binary compatible to the last release and can
therefore be used as a drop in replacement for 3.3.2. Note that the value of
org.apache.commons.lang3.time.DurationFormatUtils.ISO_EXTENDED_FORMAT_PATTERN
has changed, which may affect clients using the constant. Furthermore the
constant is used internally in
o DurationFormatUtils.formatDurationISO(long)
o DurationFormatUtils.formatPeriodISO(long, long)

For more information see https://issues.apache.org/jira/browse/LANG-1000.

NEW FEATURES
==============

* LANG-821:  Support OS X versions in SystemUtils. Thanks to Timo Kockert.
* LANG-1103: Add SystemUtils.IS_JAVA_1_9
* LANG-1093: Add ClassUtils.getAbbreviatedName(). Thanks to Fabian Lange.
* LANG-1082: Add option to disable the "objectsTriviallyEqual" test in
             DiffBuilder. Thanks to Jonathan Baker.
* LANG-1015: Add JsonToStringStyle implementation to ToStringStyle. Thanks to
             Thiago Andrade.
* LANG-1080: Add NoClassNameToStringStyle implementation of ToStringStyle.
             Thanks to Innokenty Shuvalov.
* LANG-883:  Add StringUtils.containsAny(CharSequence, CharSequence...) method.
             Thanks to Daniel Stewart.
* LANG-1052: Multiline recursive to string style. Thanks to Jan Mat�rne.
* LANG-536:  Add isSorted() to ArrayUtils. Thanks to James Sawle.
* LANG-1033: Add StringUtils.countMatches(CharSequence, char)
* LANG-1021: Provide methods to retrieve all fields/methods annotated with a
             specific type. Thanks to Alexander M�ller.
* LANG-1016: NumberUtils#isParsable method(s). Thanks to
             Juan Pablo Santos Rodr�guez.
* LANG-999:  Add fuzzy String matching logic to StringUtils. Thanks to
             Ben Ripkens.
* LANG-994:  Add zero copy read method to StrBuilder. Thanks to
             Mikhail Mazursky.
* LANG-993:  Add zero copy write method to StrBuilder. Thanks to
             Mikhail Mazursky.
* LANG-1044: Add method MethodUtils.invokeExactMethod(Object, String)
* LANG-1045: Add method MethodUtils.invokeMethod(Object, String)

FIXED BUGS
============

* LANG-794:  SystemUtils.IS_OS_WINDOWS_2008, VISTA are incorrect. Thanks to
             Timo Kockert.
* LANG-1104: Parse test fails for TimeZone America/Sao_Paulo
* LANG-948:  Exception while using ExtendedMessageFormat and escaping braces.
             Thanks to Andrey Khobnya.
* LANG-1092: Wrong formatting of time zones with daylight saving time in
             FastDatePrinter
* LANG-1090: FastDateParser does not set error indication in ParsePosition
* LANG-1089: FastDateParser does not handle excess hours as per
             SimpleDateFormat
* LANG-1061: FastDateParser error - timezones not handled correctly. Thanks to
             dmeneses.
* LANG-1087: NumberUtils#createNumber() returns positive BigDecimal when
             negative Float is expected. Thanks to Renat Zhilkibaev.
* LANG-1081: DiffBuilder.append(String, Object left, Object right) does not do
             a left.equals(right) check. Thanks to Jonathan Baker.
* LANG-1055: StrSubstitutor.replaceSystemProperties does not work consistently.
             Thanks to Jonathan Baker.
* LANG-1083: Add (T) casts to get unit tests to pass in old JDK. Thanks to
             Jonathan Baker.
* LANG-1073: Read wrong component type of array in add in ArrayUtils.
             Thanks to haiyang li.
* LANG-1077: StringUtils.ordinalIndexOf("aaaaaa", "aa", 2) != 3 in StringUtils.
             Thanks to haiyang li.
* LANG-1072: Duplicated "0x" check in createBigInteger in NumberUtils. Thanks
             to haiyang li.
* LANG-1064: StringUtils.abbreviate description doesn't agree with the
             examples. Thanks to B.J. Herbison.
* LANG-1041: Fix MethodUtilsTest so it does not depend on JDK method ordering.
             Thanks to Alexandre Bartel.
* LANG-1000: ParseException when trying to parse UTC dates with Z as zone
             designator using DateFormatUtils.ISO_DATETIME_TIME_ZONE_FORMAT
* LANG-1035: Javadoc for EqualsBuilder.reflectionEquals() is unclear
* LANG-1001: ISO 8601 misspelled throughout the Javadocs. Thanks to
             Michael Osipov.
* LANG-1088: FastDateParser should be case insensitive
* LANG-995:  Fix bug with stripping spaces on last line in WordUtils.wrap().
             Thanks to Andrey Khobnya.

CHANGES
=========

* LANG-1102: Make logic for comparing OS versions in SystemUtils smarter
* LANG-1091: Shutdown thread pools in test cases. Thanks to Fabian Lange.
* LANG-1101: FastDateParser and FastDatePrinter support 'X' format
* LANG-1100: Avoid memory allocation when using date formatting to StringBuffer.
             Thanks to mbracher.
* LANG-935:  Possible performance improvement on string escape functions.
             Thanks to Fabian Lange, Thomas Neidhart.
* LANG-1098: Avoid String allocation in StrBuilder.append(CharSequence). Thanks
             to Mikhail Mazurskiy, Fabian Lange.
* LANG-1098: Update maven-checkstyle-plugin to 2.14. Thanks to Micha? Kordas.
* LANG-1097: Update org.easymock:easymock to 3.3.1. Thanks to Micha? Kordas.
* LANG-1096: Update maven-pmd-plugin to 3.4. Thanks to Micha? Kordas.
* LANG-1095: Update maven-antrun-plugin to 1.8. Thanks to Micha? Kordas.
* LANG-877:  Performance improvements for StringEscapeUtils. Thanks to
             Fabian Lange.
* LANG-1071: Fix wrong examples in Javadoc of
             StringUtils.replaceEachRepeatedly(...),
             StringUtils.replaceEach(...) Thanks to Arno Noordover.
* LANG-827:  CompareToBuilder's doc doesn't specify precedence of fields it
             uses in performing comparisons
* LANG-1020: Improve performance of normalize space. Thanks to Libor Ondrusek.
* LANG-1027: org.apache.commons.lang3.SystemUtils#isJavaVersionAtLeast should
             return true by default
* LANG-1026: Bring static method references in StringUtils to consistent style.
             Thanks to Alex Yursha.
* LANG-1017: Use non-ASCII digits in Javadoc examples for
             StringUtils.isNumeric. Thanks to Christoph Schneegans.
* LANG-1008: Change min/max methods in NumberUtils/IEEE754rUtils from array
             input parameters to varargs. Thanks to Thiago Andrade.
* LANG-1006: Add wrap (with String or char) to StringUtils. Thanks to
             Thiago Andrade.
* LANG-1005: Extend DurationFormatUtils#formatDurationISO default pattern to
             match #formatDurationHMS. Thanks to Michael Osipov.
* LANG-1007: Fixing NumberUtils JAVADoc comments for max methods. Thanks to
             Thiago Andrade.
* LANG-731:  Better Javadoc for BitField class
* LANG-1004: DurationFormatUtils#formatDurationHMS implementation does not
             correspond to Javadoc and vice versa. Thanks to Michael Osipov.
* LANG-1003: DurationFormatUtils are not able to handle negative
             durations/periods
* LANG-998:  Javadoc is not clear on preferred pattern to instantiate
             FastDateParser / FastDatePrinter

-----------------------------------------------------------------------------

Apache Commons Lang 3.3.2 Release Notes
---------------------------------------

NEW FEATURES
==============

* LANG-989:  Add org.apache.commons.lang3.SystemUtils.IS_JAVA_1_8

FIXED BUGS
============

* LANG-992:  NumberUtils#isNumber() returns false for "0.0", "0.4790", et al

-----------------------------------------------------------------------------

Apache Commons Lang 3.3.1 Release Notes
---------------------------------------

FIXED BUGS
============

* LANG-987:  DateUtils.getFragmentInDays(Date, Calendar.MONTH) returns wrong
             days
* LANG-983:  DurationFormatUtils does not describe format string fully
* LANG-981:  DurationFormatUtils#lexx does not detect unmatched quote char
* LANG-984:  DurationFormatUtils does not handle large durations correctly
* LANG-982:  DurationFormatUtils.formatDuration(61999, "s.SSSS") - ms field
             size should be 4 digits
* LANG-978:  Failing tests with Java 8 b128

-----------------------------------------------------------------------------

Apache Commons Lang 3.3 Release Notes
-------------------------------------

NEW FEATURES
==============

* LANG-955:  Add methods for removing all invalid characters according to
             XML 1.0 and XML 1.1 in an input string to StringEscapeUtils.
             Thanks to Adam Hooper.
* LANG-970:  Add APIs MutableBoolean setTrue() and setFalse()
* LANG-962:  Add SerializationUtils.roundtrip(T extends Serializable) to
             serialize then deserialize
* LANG-637:  There should be a DifferenceBuilder with a
             ReflectionDifferenceBuilder implementation
* LANG-944:  Add the Jaro-Winkler string distance algorithm to StringUtils.
             Thanks to Rekha Joshi.
* LANG-417:  New class ClassPathUtils with methods for turning FQN into
             resource path
* LANG-834:  Validate: add inclusiveBetween and exclusiveBetween overloads
             for primitive types
* LANG-900:  New RandomUtils class. Thanks to Duncan Jones.
* LANG-966:  Add IBM OS/400 detection

FIXED BUGS
============

* LANG-621:  ReflectionToStringBuilder.toString does not debug 3rd party object
             fields within 3rd party object. Thanks to Philip Hodges,
             Thomas Neidhart.
* LANG-977:  NumericEntityEscaper incorrectly encodes supplementary characters.
             Thanks to Chris Karcher.
* LANG-973:  Make some private fields final
* LANG-971:  NumberUtils#isNumber(String) fails to reject invalid Octal numbers
* LANG-972:  NumberUtils#isNumber does not allow for hex 0XABCD
* LANG-969:  StringUtils.toEncodedString(byte[], Charset) needlessly throws
             UnsupportedEncodingException. Thanks to Matt Bishop.
* LANG-946:  ConstantInitializerTest fails when building with IBM JDK 7
* LANG-954:  uncaught PatternSyntaxException in FastDateFormat on Android.
             Thanks to Michael Keppler.
* LANG-936:  StringUtils.getLevenshteinDistance with too big of a threshold
             returns wrong result. Thanks to Yaniv Kunda, Eli Lindsey.
* LANG-943:  Test DurationFormatUtilsTest.testEdgeDuration fails in
             JDK 1.6, 1.7 and 1.8, BRST time zone
* LANG-613:  ConstructorUtils.getAccessibleConstructor() Does Not Check the
             Accessibility of Enclosing Classes
* LANG-951:  Fragments are wrong by 1 day when using fragment YEAR or MONTH.
             Thanks to Sebastian G�tz.
* LANG-950:  FastDateParser does not handle two digit year parsing like
             SimpleDateFormat
* LANG-949:  FastDateParserTest.testParses does not test FastDateParser
* LANG-915:  Wrong locale handling in LocaleUtils.toLocale().
             Thanks to Sergio Fern�ndez.

CHANGES
=========

* LANG-961:  org.apache.commons.lang3.reflect.FieldUtils.removeFinalModifier(Field)
             does not clean up after itself
* LANG-958:  FastDateParser javadoc incorrectly states that SimpleDateFormat
             is used internally
* LANG-956:  Improve Javadoc of WordUtils.wrap methods
* LANG-939:  Move Documentation from user guide to package-info files
* LANG-953:  Convert package.html files to package-info.java files
* LANG-940:  Fix deprecation warnings
* LANG-819:  EnumUtils.generateBitVector needs a "? extends"

-----------------------------------------------------------------------------

Apache Commons Lang 3.2.1 Release Notes
---------------------------------------

BUG FIXES
===========

* LANG-937:  Fix missing Hamcrest dependency in Ant Build
* LANG-941:  Test failure in LocaleUtilsTest when building with JDK 8
* LANG-942:  Test failure in FastDateParserTest and FastDateFormat_ParserTest
             when building with JDK8. Thanks to Bruno P. Kinoshita,
             Henri Yandell.
* LANG-938:  Build fails with test failures when building with JDK 8

-----------------------------------------------------------------------------

Apache Commons Lang 3.2 Release Notes
----------------------------------------

COMPATIBILITY WITH 3.1
========================

This release introduces backwards incompatible changes in
org.apache.commons.lang3.time.FastDateFormat:
o Method 'protected java.util.List parsePattern()' has been removed
o Method 'protected java.lang.String parseToken(java.lang.String, int[])' has
  been removed
o Method 'protected org.apache.commons.lang3.time.FastDateFormat$NumberRule
  selectNumberRule(int, int)' has been removed

These changes were the result of [LANG-462]. It is assumed that this change
will not break clients as Charles Honton pointed out on 25/Jan/12:
"
 1. Methods "FastDateFormat$NumberRule selectNumberRule(int, int)" and
    "List<Rule> parsePattern()" couldn't have been overridden because
    NumberRule and Rule were private to FastDateFormat.
 2. Due to the factory pattern used, it's unlikely other two methods would have
    been overridden.
 3. The four methods are highly implementation specific. I consider it a
    mistake that the methods were exposed.
"
For more information see https://issues.apache.org/jira/browse/LANG-462.

NEW FEATURES
==============

* LANG-934:  Add removeFinalModifier to FieldUtils
* LANG-863:  Method returns number of inheritance hops between parent and
             subclass. Thanks to Daneel S. Yaitskov.
* LANG-774:  Added isStarted, isSuspended and isStopped to StopWatch.
             Thanks to Erhan Bagdemir.
* LANG-848:  Added StringUtils.isBlank/isEmpty CharSequence... methods.
             Thanks to Alexander Muthmann.
* LANG-926:  Added ArrayUtils.reverse(array, from, to) methods.
* LANG-795:  StringUtils.toString(byte[], String) deprecated in favour of a new
             StringUtils.toString(byte[], CharSet). Thanks to Aaron Digulla.
* LANG-893:  StrSubstitutor now supports default values for variables.
             Thanks to Woonsan Ko.
* LANG-913:  Adding .gitignore to commons-lang. Thanks to Allon Mureinik.
* LANG-837:  Add ObjectUtils.toIdentityString methods that support
             StringBuilder, StrBuilder, and Appendable.
* LANG-886:  Added CharSetUtils.containsAny(String, String).
* LANG-797:  Added escape/unescapeJson to StringEscapeUtils.
* LANG-875:  Added appendIfMissing and prependIfMissing methods to StringUtils.
* LANG-870:  Add StringUtils.LF and StringUtils.CR values.
* LANG-873:  Add FieldUtils getAllFields() to return all the fields defined in
             the given class and super classes.
* LANG-835:  StrBuilder should support StringBuilder as an input parameter.
* LANG-857:  StringIndexOutOfBoundsException in CharSequenceTranslator.
* LANG-856:  Code refactoring in NumberUtils.
* LANG-855:  NumberUtils#createBigInteger does not allow for hex and octal
             numbers.
* LANG-854:  NumberUtils#createNumber - does not allow for hex numbers to be
             larger than Long.
* LANG-853:  StringUtils join APIs for primitives.
* LANG-841:  Add StringUtils API to call String.replaceAll in DOTALL a.k.a.
             single-line mode.
* LANG-825:  Create StrBuilder APIs similar to
             String.format(String, Object...).
* LANG-675:  Add Triple class (ternary version of Pair).
* LANG-462:  FastDateFormat supports parse methods.

BUG FIXES
===========

* LANG-932:  Spelling fixes. Thanks to Ville Skytt�.
* LANG-929:  OctalUnescaper tried to parse all of \279.
* LANG-928:  OctalUnescaper had bugs when parsing octals starting with a zero.
* LANG-905:  EqualsBuilder returned true when comparing arrays, even when the
             elements are different.
* LANG-917:  Fixed exception when combining custom and choice format in
             ExtendedMessageFormat. Thanks to Arne Burmeister.
* LANG-902:  RandomStringUtils.random javadoc was incorrectly promising letters
             and numbers would, as opposed to may, appear  Issue:. Thanks to
             Andrzej Winnicki.
* LANG-921:  BooleanUtils.xor(boolean...) produces wrong results.
* LANG-896:  BooleanUtils.toBoolean(String str) javadoc is not updated. Thanks
             to Mark Bryan Yu.
* LANG-879:  LocaleUtils test fails with new Locale "ja_JP_JP_#u-ca-japanese"
             of JDK7.
* LANG-836:  StrSubstitutor does not support StringBuilder or CharSequence.
             Thanks to Arnaud Brunet.
* LANG-693:  Method createNumber from NumberUtils doesn't work for floating
             point numbers other than Float  Issue: LANG-693. Thanks to
             Calvin Echols.
* LANG-887:  FastDateFormat does not use the locale specific cache correctly.
* LANG-754:  ClassUtils.getShortName(String) will now only do a reverse lookup
             for array types.
* LANG-881:  NumberUtils.createNumber() Javadoc says it does not work for octal
             numbers.
* LANG-865:  LocaleUtils.toLocale does not parse strings starting with an
             underscore.
* LANG-858:  StringEscapeUtils.escapeJava() and escapeEcmaScript() do not
             output the escaped surrogate pairs that are Java parsable.
* LANG-849:  FastDateFormat and FastDatePrinter generates Date objects
             wastefully.
* LANG-845:  Spelling fixes.
* LANG-844:  Fix examples contained in javadoc of StringUtils.center methods.
* LANG-832:  FastDateParser does not handle unterminated quotes correctly.
* LANG-831:  FastDateParser does not handle white-space properly.
* LANG-830:  FastDateParser could use \Q \E to quote regexes.
* LANG-828:  FastDateParser does not handle non-Gregorian calendars properly.
* LANG-826:  FastDateParser does not handle non-ASCII digits correctly.
* LANG-822:  NumberUtils#createNumber - bad behavior for leading "--".
* LANG-818:  FastDateFormat's "z" pattern does not respect timezone of Calendar
             instances passed to format().
* LANG-817:  Add org.apache.commons.lang3.SystemUtils.IS_OS_WINDOWS_8.
* LANG-813:  StringUtils.equalsIgnoreCase doesn't check string reference
             equality.
* LANG-810:  StringUtils.join() endIndex, bugged for loop.
* LANG-807:  RandomStringUtils throws confusing IAE when end <= start.
* LANG-805:  RandomStringUtils.random(count, 0, 0, false, false, universe,
             random) always throws java.lang.ArrayIndexOutOfBoundsException.
* LANG-802:  LocaleUtils - unnecessary recursive call in SyncAvoid class.
* LANG-800:  Javadoc bug in DateUtils#ceiling for Calendar and Object versions.
* LANG-788:  SerializationUtils throws ClassNotFoundException when cloning
             primitive classes.
* LANG-786:  StringUtils equals() relies on undefined behavior.
* LANG-783:  Documentation bug: StringUtils.split.
* LANG-777:  jar contains velocity template of release notes.
* LANG-776:  TypeUtilsTest contains incorrect type assignability assertion.
* LANG-775:  TypeUtils.getTypeArguments() misses type arguments for
             partially-assigned classes.
* LANG-773:  ImmutablePair doc contains nonsense text.
* LANG-772:  ClassUtils.PACKAGE_SEPARATOR Javadoc contains garbage text.
* LANG-765:  EventListenerSupport.ProxyInvocationHandler no longer defines
             serialVersionUID.
* LANG-764:  StrBuilder is now serializable.
* LANG-761:  Fix Javadoc Ant warnings.
* LANG-747:  NumberUtils does not handle Long Hex numbers.
* LANG-743:  Javadoc bug in static inner class DateIterator.

CHANGES
=========

* LANG-931:  Misleading Javadoc comment in StrBuilderReader class. Thanks
             to Christoph Schneegans.
* LANG-910:  StringUtils.normalizeSpace now handles non-breaking spaces
             (Unicode 00A0). Thanks to Timur Yarosh.
* LANG-804:  Redundant check for zero in HashCodeBuilder ctor. Thanks to
             Allon Mureinik.
* LANG-884:  Simplify FastDateFormat; eliminate boxing.
* LANG-882:  LookupTranslator now works with implementations of CharSequence
             other than String.
* LANG-846:  Provide CharSequenceUtils.regionMatches with a proper green
             implementation instead of inefficiently converting to Strings.
* LANG-839:  ArrayUtils removeElements methods use unnecessary HashSet.
* LANG-838:  ArrayUtils removeElements methods clone temporary index arrays
             unnecessarily.
* LANG-799:  DateUtils#parseDate uses default locale; add Locale support.
* LANG-798:  Use generics in SerializationUtils.

CHANGES WITHOUT TICKET
========================

o Fixed URLs in javadoc to point to new oracle.com pages

-----------------------------------------------------------------------------

Apache Commons Lang 3.1 Release Notes
-------------------------------------

NEW FEATURES
==============

* LANG-801:  Add Conversion utility to convert between data types on byte level
* LANG-760:  Add API StringUtils.toString(byte[] input, String charsetName)
* LANG-756:  Add APIs ClassUtils.isPrimitiveWrapper(Class<?>) and
             isPrimitiveOrWrapper(Class<?>)
* LANG-695:  SystemUtils.IS_OS_UNIX doesn't recognize FreeBSD as a Unix system

BUG FIXES
===========

* LANG-749:  Incorrect Bundle-SymbolicName in Manifest
* LANG-746:  NumberUtils does not handle upper-case hex: 0X and -0X
* LANG-744:  StringUtils throws java.security.AccessControlException on Google
             App Engine
* LANG-741:  Ant build has wrong component.name
* LANG-698:  Document that the Mutable numbers don't work as expected with
             String.format

CHANGES
=========

* LANG-758:  Add an example with whitespace in StringUtils.defaultIfEmpty
* LANG-752:  Fix createLong() so it behaves like createInteger()
* LANG-751:  Include the actual type in the Validate.isInstance and
             isAssignableFrom exception messages
* LANG-748:  Deprecating chomp(String, String)
* LANG-736:  CharUtils static final array CHAR_STRING is not needed to compute
             CHAR_STRING_ARRAY

-----------------------------------------------------------------------------

Apache Commons Lang 3.0 Release Notes
-------------------------------------

ADDITIONS
===========

* LANG-276:  MutableBigDecimal and MutableBigInteger.
* LANG-285:  Wish : method unaccent.
* LANG-358:  ObjectUtils.coalesce.
* LANG-386:  LeftOf/RightOfNumber in Range convenience methods necessary.
* LANG-435:  Add ClassUtils.isAssignable() variants with autoboxing.
* LANG-444:  StringUtils.emptyToNull.
* LANG-482:  Enhance StrSubstitutor to support nested ${var-${subvr}} expansion
* LANG-482:  StrSubstitutor now supports substitution in variable names.
* LANG-496:  A generic implementation of the Lazy initialization pattern.
* LANG-497:  Addition of ContextedException and ContextedRuntimeException.
* LANG-498:  Add StringEscapeUtils.escapeText() methods.
* LANG-499:  Add support for the handling of ExecutionExceptions.
* LANG-501:  Add support for background initialization.
* LANG-529:  Add a concurrent package.
* LANG-533:  Validate: support for validating blank strings.
* LANG-537:  Add ArrayUtils.toArray to create generic arrays.
* LANG-545:  Add ability to create a Future for a constant.
* LANG-546:  Add methods to Validate to check whether the index is valid for
             the array/list/string.
* LANG-553:  Add TypeUtils class to provide utility code for working with generic
             types.
* LANG-559:  Added isAssignableFrom and isInstanceOf validation methods.
* LANG-559:  Added validState validation method.
* LANG-560:  New TimedSemaphore class.
* LANG-582:  Provide an implementation of the ThreadFactory interface.
* LANG-588:  Create a basic Pair<L, R> class.
* LANG-594:  DateUtils equal & compare functions up to most significant field.
* LANG-601:  Add Builder Interface / Update Builders to Implement It.
* LANG-609:  Support lazy initialization using atomic variables
* LANG-610:  Extend exception handling in ConcurrentUtils to runtime exceptions.
* LANG-614:  StringUtils.endsWithAny method
* LANG-640:  Add normalizeSpace to StringUtils
* LANG-644:  Provide documentation about the new concurrent package
* LANG-649:  BooleanUtils.toBooleanObject to support single character input
* LANG-651:  Add AnnotationUtils
* LANG-653:  Provide a very basic ConcurrentInitializer implementation
* LANG-655:  Add StringUtils.defaultIfBlank()
* LANG-667:  Add a Null-safe compare() method to ObjectUtils
* LANG-676:  Documented potential NPE if auto-boxing occurs for some BooleanUtils
             methods
* LANG-678:  Add support for ConcurrentMap.putIfAbsent()
* LANG-692:  Add hashCodeMulti varargs method
* LANG-697:  Add FormattableUtils class
* LANG-684:  Levenshtein Distance Within a Given Threshold

REMOVALS
==========

* LANG-438:  Remove @deprecateds.
* LANG-492:  Remove code handled now by the JDK.
* LANG-493:  Remove code that does not hold enough value to remain.
* LANG-590:  Remove JDK 1.2/1.3 bug handling in
             StringUtils.indexOf(String, String, int).
* LANG-673:  WordUtils.abbreviate() removed
* LANG-691:  Removed DateUtils.UTC_TIME_ZONE

IMPROVEMENTS
==============

* LANG-290:  EnumUtils for JDK 5.0.
* LANG-336:  Finally start using generics.
* LANG-355:  StrBuilder should implement CharSequence and Appendable.
* LANG-396:  Investigate for vararg usages.
* LANG-424:  Improve Javadoc for StringUtils class.
* LANG-458:  Refactor Validate.java to eliminate code redundancy.
* LANG-479:  Document where in SVN trunk is.
* LANG-504:  bring ArrayUtils.isEmpty to the generics world.
* LANG-505:  Rewrite StringEscapeUtils.
* LANG-507:  StringEscapeUtils.unescapeJava should support \u+ notation.
* LANG-510:  Convert StringUtils API to take CharSequence.
* LANG-513:  Better EnumUtils.
* LANG-528:  Mutable classes should implement an appropriately typed Mutable
             interface.
* LANG-539:  Compile commons.lang for CDC 1.1/Foundation 1.1.
* LANG-540:  Make NumericEntityEscaper immutable.
* LANG-541:  Replace StringBuffer with StringBuilder.
* LANG-548:  Use Iterable on API instead of Collection.
* LANG-551:  Replace Range classes with generic version.
* LANG-562:  Change Maven groupId.
* LANG-563:  Change Java package name.
* LANG-570:  Do the test cases really still require main() and suite() methods?
* LANG-579:  Add new Validate methods.
* LANG-599:  ClassUtils.getClass(): Allow Dots as Inner Class Separators.
* LANG-605:  DefaultExceptionContext overwrites values in recursive situations.
* LANG-668:  Change ObjectUtils min() & max() functions to use varargs rather
             than just two parameters
* LANG-681:  Push down WordUtils to "text" sub-package.
* LANG-711:  Add includeantruntime=false to javac targets to quell warnings in
             ant 1.8.1 and better (and modest performance gain).
* LANG-713:  Increase test coverage of FieldUtils read methods and tweak
             javadoc.
* LANG-718:  build.xml Java 1.5+ updates.

BUG FIXES
===========

* LANG-11:   Depend on JDK 1.5+.
* LANG-302:  StrBuilder does not implement clone().
* LANG-339:  StringEscapeUtils.escapeHtml() escapes multibyte characters like
             Chinese, Japanese, etc.
* LANG-369:  ExceptionUtils not thread-safe.
* LANG-418:  Javadoc incorrect for StringUtils.endsWithIgnoreCase.
* LANG-428:  StringUtils.isAlpha, isAlphanumeric and isNumeric now return false
             for ""
* LANG-439:  StringEscapeUtils.escapeHTML() does not escape chars (0x00-0x20).
* LANG-448:  Lower Ascii Characters don't get encoded by Entities.java.
* LANG-468:  JDK 1.5 build/runtime failure on LANG-393 (EqualsBuilder).
* LANG-474:  Fixes for thread safety.
* LANG-478:  StopWatch does not resist to system time changes.
* LANG-480:  StringEscapeUtils.escapeHtml incorrectly converts unicode
             characters above U+00FFFF into 2 characters.
* LANG-481:  Possible race-conditions in hashCode of the range classes.
* LANG-564:  Improve StrLookup API documentation.
* LANG-568:  @SuppressWarnings("unchecked") is used too generally.
* LANG-571:  ArrayUtils.add(T[:  array, T element) can create unexpected
             ClassCastException.
* LANG-585:  exception.DefaultExceptionContext.getFormattedExceptionMessage
             catches Throwable.
* LANG-596:  StrSubstitutor should also handle the default properties of a
             java.util.Properties class
* LANG-600:  Javadoc is incorrect for public static int
             lastIndexOf(String str, String searchStr).
* LANG-602:  ContextedRuntimeException no longer an 'unchecked' exception.
* LANG-606:  EqualsBuilder causes StackOverflowException.
* LANG-608:  Some StringUtils methods should take an int character instead of
             char to use String API features.
* LANG-617:  StringEscapeUtils.escapeXML() can't process UTF-16 supplementary
             characters
* LANG-624:  SystemUtils.getJavaVersionAsFloat throws
             StringIndexOutOfBoundsException on Android runtime/Dalvik VM
* LANG-629:  Charset may not be threadsafe, because the HashSet is not synch.
* LANG-638:  NumberUtils createNumber throws a StringIndexOutOfBoundsException
             when argument containing "e" and "E" is passed in
* LANG-643:  Javadoc StringUtils.left() claims to throw on negative len, but
             doesn't
* LANG-645:  FastDateFormat.format() outputs incorrect week of year because
             locale isn't respected
* LANG-646:  StringEscapeUtils.unescapeJava doesn't handle octal escapes and
             Unicode with extra u
* LANG-656:  Example StringUtils.indexOfAnyBut("zzabyycdxx", '') = 0 incorrect
* LANG-658:  Some entities like &Ouml; are not matched properly against its
             ISO8859-1 representation
* LANG-659:  EntityArrays typo: {"\u2122", "&minus;"}, // minus sign, U+2212
             ISOtech
* LANG-66:   StringEscaper.escapeXml() escapes characters > 0x7f.
* LANG-662:  org.apache.commons.lang3.math.Fraction does not reduce
             (Integer.MIN_VALUE, 2^k)
* LANG-663:  org.apache.commons.lang3.math.Fraction does not always succeed in
             multiplyBy and divideBy
* LANG-664:  NumberUtils.isNumber(String) is not right when the String is
             "1.1L"
* LANG-672:  Doc bug in DateUtils#ceiling
* LANG-677:  DateUtils.isSameLocalTime compares using 12 hour clock and not
             24 hour
* LANG-685:  EqualsBuilder synchronizes on HashCodeBuilder.
* LANG-703:  StringUtils.join throws NPE when toString returns null for one of
             objects in collection
* LANG-710:  StringIndexOutOfBoundsException when calling unescapeHtml4("&#03")
* LANG-714:  StringUtils doc/comment spelling fixes.
* LANG-715:  CharSetUtils.squeeze() speedup.
* LANG-716:  swapCase and *capitalize speedups.


Historical list of changes: https://commons.apache.org/lang/changes-report.html

For complete information on Commons Lang, including instructions on how to
submit bug reports, patches, or suggestions for improvement, see the
Apache Commons Lang website:

https://commons.apache.org/lang/

Have fun!
-Apache Commons Lang team