You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by gg...@apache.org on 2025/07/04 22:14:02 UTC

(commons-lang) 03/03: Prepare for the next release candidate

This is an automated email from the ASF dual-hosted git repository.

ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-lang.git

commit 780d34ef4e42fc1402b12c62ea77a77b554e0b09
Author: Gary D. Gregory <ga...@gmail.com>
AuthorDate: Fri Jul 4 22:13:53 2025 +0000

    Prepare for the next release candidate
---
 CONTRIBUTING.md                  |   4 +-
 README.md                        |   6 +-
 RELEASE-NOTES.txt                | 283 ++++++++++++++++++++++++++++++---------
 src/changes/changes.xml          |   2 +-
 src/site/xdoc/download_lang.xml  |  34 ++---
 src/site/xdoc/issue-tracking.xml |  12 +-
 src/site/xdoc/mail-lists.xml     |   2 +-
 7 files changed, 249 insertions(+), 94 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2d38a07fb..040ae7a3e 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -61,11 +61,11 @@ Making Changes
 
 + Create a _topic branch_ for your isolated work.
   * Usually you should base your branch from the `master` branch.
-  * A good topic branch name can be the JIRA bug ID plus a keyword, for example, `LANG-123-InputStream`.
+  * A good topic branch name can be the JIRA bug ID plus a keyword, e.g. `LANG-123-InputStream`.
   * If you have submitted multiple JIRA issues, try to maintain separate branches and pull requests.
 + Make commits of logical units.
   * Make sure your commit messages are meaningful and in the proper format. Your commit message should contain the key of the JIRA issue.
-  * For example, `[LANG-123] Close input stream earlier`
+  * For example, `[LANG-123] Close input stream sooner`
 + Respect the original code style:
   + Only use spaces for indentation; you can check for unnecessary whitespace with `git diff` before committing.
   + Create minimal diffs - disable _On Save_ actions like _Reformat Source Code_ or _Organize Imports_. If you feel the source code should be reformatted create a separate PR for this change first.
diff --git a/README.md b/README.md
index 4d4368566..0432cf306 100644
--- a/README.md
+++ b/README.md
@@ -45,7 +45,7 @@ Apache Commons Lang
 
 [![Java CI](https://github.com/apache/commons-lang/actions/workflows/maven.yml/badge.svg)](https://github.com/apache/commons-lang/actions/workflows/maven.yml)
 [![Maven Central](https://img.shields.io/maven-central/v/org.apache.commons/commons-lang3?label=Maven%20Central)](https://search.maven.org/artifact/org.apache.commons/commons-lang3)
-[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-lang3/3.17.0.svg)](https://javadoc.io/doc/org.apache.commons/commons-lang3/3.17.0)
+[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-lang3/3.18.0.svg)](https://javadoc.io/doc/org.apache.commons/commons-lang3/3.18.0)
 [![CodeQL](https://github.com/apache/commons-lang/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/apache/commons-lang/actions/workflows/codeql-analysis.yml)
 [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/apache/commons-lang/badge)](https://api.securityscorecards.dev/projects/github.com/apache/commons-lang)
 
@@ -76,7 +76,7 @@ Alternatively, you can pull it from the central Maven repositories:
 <dependency>
   <groupId>org.apache.commons</groupId>
   <artifactId>commons-lang3</artifactId>
-  <version>3.17.0</version>
+  <version>3.18.0</version>
 </dependency>
 ```
 
@@ -98,7 +98,7 @@ There are some guidelines which will make applying PRs easier for us:
 + Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
 + Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running `mvn`.
 + Before you pushing a PR, run `mvn` (by itself), this runs the default goal, which contains all build checks.
-+ To see the code coverage report, regardless of coverage failures, run `mvn clean site -Dcommons.jacoco.haltOnFailure=false`
++ To see the code coverage report, regardless of coverage failures, run `mvn clean site -Dcommons.jacoco.haltOnFailure=false -Pjacoco`
 
 If you plan to contribute on a regular basis, please consider filing a [contributor license agreement](https://www.apache.org/licenses/#clas).
 You can learn more about contributing via GitHub in our [contribution guidelines](CONTRIBUTING.md).
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 796b4ebaa..716fdba86 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -14,11 +14,165 @@ 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.18.0 Release Notes
+----------------------------------------
 
-                        Apache Commons Lang
-                        Version 3.17.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:
+o            Add Strings and refactor StringUtils. Thanks to Gary Gregory.
+o LANG-1747: Add StopWatch.run([Failable]Runnable) and get([Failable]Supplier). Thanks to Oliver B. Fischer, Gary Gregory.
+o            Add JavaVersion.JAVA_23. Thanks to Gary Gregory.
+o            Add JavaVersion.JAVA_24. Thanks to Gary Gregory.
+o            Add SystemUtils.IS_JAVA_23. Thanks to Gary Gregory.
+o            Add SystemUtils.IS_JAVA_24. Thanks to Gary Gregory.
+o            Add IntegerRange.toIntStream(). Thanks to Gary Gregory.
+o            Add LongRange.toLongStream(). Thanks to Gary Gregory.
+o            Add IntStrams.of(int...). Thanks to Gary Gregory.
+o            Add ArrayUtils.containsAny(int[], int...). Thanks to Gary Gregory.
+o            Add CalendarUtils.toLocalDate() #725. Thanks to asgh, Gary Gregory.
+o            Add SystemUtils.IS_OS_MAC_OSX_SEQUOIA. Thanks to Gary Gregory.
+o            Add BasicThreadFactory.builder() and deprecate BasicThreadFactory.Builder(). Thanks to Gary Gregory.
+o            Add BasicThreadFactory.daemon(). Thanks to Gary Gregory.
+o            Add ArrayUtils.startsWith. Thanks to Gary Gregory.
+o            Add Predicates. Thanks to Gary Gregory.
+o            Add RegExUtils methods typed to CharSequence input and deprecate old versions typed to String. Thanks to Gary Gregory.
+o            Add IterableStringTokenizer. Thanks to Gary Gregory.
+o            Add FailableIntToFloatFunction. Thanks to Gary Gregory.
+o            Add Validate.isTrue(boolean, Supplier<String>). Thanks to Gary Gregory.
+o            Add EnumUtils.getFirstEnum(Class<E>, int, ToIntFunction<E>, E). Thanks to Gary Gregory.
+o            Add FailableToBooleanFunction. Thanks to Gary Gregory.
+o            Add the @FunctionalInterface annotation to org.apache.commons.lang3.concurrent.Computable. Thanks to Gary Gregory.
+o            Add SystemUtils.getJavaIoTmpDirPath(). Thanks to Gary Gregory.
+o            Add SystemUtils.getJavaHomePath(). Thanks to Gary Gregory.
+o            Add SystemUtils.getUserDirPath(). Thanks to Gary Gregory.
+o            Add SystemUtils.getUserHomePath(). Thanks to Gary Gregory.
+o            Add ArrayFill.fill(T[], FailableIntFunction)). Thanks to Gary Gregory.
+o            Add SystemProperties.JAVA_SECURITY_DEBUG. Thanks to Gary Gregory.
+o            Add SystemProperties.JAVA_SECURITY_KERBEROS_CONF. Thanks to Gary Gregory.
+o            Add SystemProperties.JAVA_SECURITY_KERBEROS_KDC. Thanks to Gary Gregory.
+o            Add SystemProperties.JAVA_SECURITY_KERBEROS_REAL. Thanks to Gary Gregory.
+o            Add ArrayFill.fill(boolean[], boolean) #1386. Thanks to kommalapatiraviteja.
+o            Add ObjectUtils.getIfNull(Object, Object) and deprecate defaultIfNull(Object, Object). Thanks to Pankraz76, Gary Gregory.
+o            org.apache.commons.lang3.mutable.Mutable now extends Supplier. Thanks to Gary Gregory.
+o            Add org.apache.commons.lang3.CharUtils.isHex(char). Thanks to Gary Gregory.
+o            Add org.apache.commons.lang3.CharUtils.isOctal(char). Thanks to Gary Gregory.
+o            Add org.apache.commons.lang3.concurrent.locks.LockingVisitors.reentrantLockVisitor(Object). Thanks to Gary Gregory.
+o            Add org.apache.commons.lang3.concurrent.locks.LockingVisitors.create(Object, ReentrantLock). Thanks to Gary Gregory.
+o            Add org.apache.commons.lang3.concurrent.locks.LockingVisitors.ReentrantLockVisitor. Thanks to Gary Gregory.
+o            Add builders for LockingVisitors implementations. Thanks to Gary Gregory.
+o            Add EnumSet.stream(Class). Thanks to Gary Gregory.
+o            Add org.apache.commons.lang3.SystemProperties.isPropertySet(String). Thanks to Gary Gregory.
+
+Fixed Bugs:
+o            Fix flaky FileUtilsWaitForTest.testWaitForNegativeDuration(). Thanks to Gary Gregory.
+o            Pick up exec-maven-plugin version from parent POM. Thanks to Gary Gregory.
+o            Speed up and sanitize StopWatchTest. Thanks to Gary Gregory.
+o            Fix handling of non-ASCII letters and numbers in RandomStringUtils #1273. Thanks to Fabrice Benhamouda.
+o            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.
+o            Remove trailing whitespace in StopWatch exception messages. Thanks to Gary Gregory.
+o LANG-1754: Use getAllSuperclassesAndInterfaces() in getMatchingMethod() #1289. Thanks to vhbcm.
+o            Add details to the ArrayFill Javadoc. Thanks to Gary Gregory.
+o            Add details to the ArraySorter Javadoc. Thanks to Gary Gregory.
+o            Fix broken URL to project location in Maven Central #1296. Thanks to Capt. Cutlass.
+o LANG-1753: StringUtils.replaceEachRepeatedly regression in 3.11+ #1297. Thanks to Capt. Cutlass.
+o            Use simplified JUnit assertion methods #1298. Thanks to Capt. Cutlass.
+o LANG-1682: Javadoc and test: Use Strings.CI.startsWithAny method instead #1299. Thanks to Capt. Cutlass.
+o            Fix NullPointerException in FastDateParser.TimeZoneStrategy.setCalendar(FastDateParser, Calendar, String) on Java 23. Thanks to Gary Gregory.
+o LANG-1757: Fix NullPointerException in MethodUtils.getMatchingAccessibleMethod((Class, String, Class...)). Thanks to Gary Gregory.
+o LANG-1698: Fix StackOverflowError in TypeUtils.typeVariableToString(TypeVariable), TypeUtils.toString(Type) on Java 17 and up. Thanks to Jan Arne Sparka, Gary Gregory.
+o LANG-1511: SystemUtils is missing important documentation. Thanks to david cogen, Gary Gregory, Bruno P. Kinoshita.
+o            Make Failable.run(FailableRunnable) null-safe. Thanks to Gary Gregory.
+o            Make Failable.accept(*) null-safe. Thanks to Gary Gregory.
+o            Improve container detection by mimicking systemd #1323. Thanks to maxxedev, Piotr P. Karwasz, Gary Gregory.
+o            Make LangCollectors.collect(...) null-safe. Thanks to Gary Gregory.
+o            Make LangCollectors.collect(...) null-safe. Thanks to Gary Gregory.
+o            Fix names of UTF-16 surrogate character test fixture constants, see also #1326. Thanks to IBue, Gary Gregory.
+o            Moditect plugin generates split package warnings. Thanks to Gary Gregory.
+o            LocaleUtils.availableLocaleSet() uses predictable iteration order. Thanks to Gary Gregory.
+o LANG-1759: SerializationUtils.clone(Object) throws ClassCastException when called with a Serializable lambda. Thanks to Maxim Butov, Gary Gregory.
+o LANG-1759: [StringUtils::indexOfAnyBut] redesign due to inconsistent/faulty behavior regarding UTF-16 surrogates #1327. Thanks to IBue, Gary Gregory, Piotr P. Karwasz.
+o            Undeprecate ObjectUtils.toString(Object). Thanks to Gary Gregory.
+o            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.
+o            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.
+o LANG-1762: StopWatch methods should not delegate to deprecated methods. Thanks to Alonso Gonzalez, Gary Gregory.
+o            Don't call TypeUtils.toString(Type) on every array item in TypeUtils.parameterize[WithOwner](Type, Class, Map, Type>) unless required. Thanks to Gary Gregory.
+o            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.
+o            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.
+o LANG-1764: Deprecate NumericEntityUnescaper.OPTION in favor of Apache Commons Text. Thanks to Gary Gregory.
+o            Several hash collisions in Fraction class. Thanks to Gary Gregory.
+o LANG-1768: MutableLong and friends should provide better parsing exceptions Javadocs. Thanks to Wang Hailong, Gary Gregory.
+o            Reimplement StringUtils.toCodePoints(CharSequence) to use java.lang.CharSequence.codePoints(). Thanks to Gary Gregory.
+o            Reimplement StringUtils.capitalize(String) to use java.lang.CharSequence.codePoints(). Thanks to Gary Gregory.
+o            Reimplement StringUtils.uncapitalize(String) to use java.lang.CharSequence.codePoints(). Thanks to Gary Gregory.
+o            org.apache.commons.lang3.ClassUtils.getCanonicalName(String) now throws an IllegalArgumentException for array dimensions greater than 255. Thanks to Gary Gregory.
+o            Fix Javadoc typo and improve clarity in defaultIfBlank method #1376. Thanks to Sridhar Balijepalli, Piotr P. Karwasz.
+o LANG-1773: Apache Commons Lang no longer builds on Android #1381. Thanks to �amonn McManus, Gary Gregory.
+o LANG-1772: Restrict size of cache to prevent overflow errors #1379. Thanks to James Winters, Piotr P. Karwasz, Gary Gregory.
+o LANG-1772: Reimplement org.apache.commons.lang3.ClassUtils.hierarchy(Class, Interfaces) using an AtomicReference. Thanks to Gary Gregory.
+o            Fix Javadoc code examples in DiffBuilder and ReflectionDiffBuilder #1400. Thanks to Ken Dombeck.
+o            Fix generics in org.apache.commons.lang3.stream.Streams.toArray(Class) signature. Thanks to Gary Gregory.
+o LANG-1727: EventListenerSupport doesn't document ordering of events. Thanks to Elliotte Rusty Harold, Gary Gregory.
+o            Fix edge-case NullPointerException in org.apache.commons.lang3.SystemUtils.IS_OS_ANDROID. Thanks to Gary Gregory.
+o            Fix edge-case NullPointerException in org.apache.commons.lang3.SystemUtils.isJavaVersionAtLeast(JavaVersion). Thanks to Gary Gregory.
+o            Fix edge-case NullPointerException in org.apache.commons.lang3.SystemUtils.isJavaVersionAtMost(JavaVersion). Thanks to Gary Gregory.
+o            Return the default enum if a SecurityException is caught in getEnumSystemProperty(). Thanks to Gary Gregory.
+o            Fix edge-case NullPointerException in org.apache.commons.lang3.EnumUtils.getEnum(Class, String, E). Thanks to Gary Gregory.
+o            org.apache.commons.lang3.EnumUtils.getFirstEnumIgnoreCase(Class, String, Function, E) now returns the given default enum on null enumClass input. Thanks to Gary Gregory.
+o            org.apache.commons.lang3.EnumUtils.getEnumIgnoreCase(Class, String, E) now returns the given default enum on null enumClass input. Thanks to Gary Gregory.
+o            org.apache.commons.lang3.EnumUtils.getEnumIgnoreCase(Class, String) now returns the given default enum on null enumClass input. Thanks to Gary Gregory.
+o            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.equalTo(A). Thanks to Gary Gregory.
+o            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.greaterThan(A). Thanks to Gary Gregory.
+o            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.greaterThanOrEqualTo(A). Thanks to Gary Gregory.
+o            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.lessThan(A). Thanks to Gary Gregory.
+o            Fix NullPointerException in org.apache.commons.lang3.compare.ComparableUtils.ComparableCheckBuilder.lessThanOrEqualTo(A). Thanks to Gary Gregory.
+
+Changes:
+o            Bump org.apache.commons:commons-parent from 73 to 85 #1267, #1277, #1283, #1288, #1302, #1377. Thanks to Gary Gregory, Dependabot.
+o            [site] Bump org.codehaus.mojo:taglist-maven-plugin from 3.1.0 to 3.2.1 #1300. Thanks to Gary Gregory, Dependabot.
+o            [test] Bump org.easymock:easymock from 5.4.0 to 5.6.0 #1317, #1387. Thanks to Gary Gregory, Dependabot.
+o            [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.
 
@@ -84,10 +238,8 @@ Apache Commons Team
 
 -----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                        Version 3.16.0
-                        Release Notes
-
+Apache Commons Lang 3.16.0 Release Notes
+----------------------------------------
 
 The Apache Commons team is pleased to announce Apache Commons Lang Version 3.16.0.
 
@@ -155,6 +307,9 @@ 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.
@@ -304,10 +459,8 @@ Have fun!
 
 -----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                        Version 3.14.0
-                        Release Notes
-
+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 
@@ -385,9 +538,8 @@ Have fun!
 
 -----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                        Version 3.13.0
-                        Release Notes
+Apache Commons Lang 3.13.0 Release Notes
+----------------------------------------
 
 
 This document contains the release notes for the 3.13.0 version of Apache Commons Lang.
@@ -623,11 +775,10 @@ Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi
 Have fun!
 -Apache Commons Team
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                        Version 3.12.0
-                        Release Notes
+Apache Commons Lang 3.12.0 Release Notes
+----------------------------------------
 
 INTRODUCTION:
 
@@ -740,11 +891,10 @@ Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi
 Have fun!
 -Apache Commons Team
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                        Version 3.11
-                        Release Notes
+Apache Commons Lang 3.11.0 Release Notes
+----------------------------------------
 
 
 INTRODUCTION:
@@ -833,11 +983,10 @@ Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi
 Have fun!
 -Apache Commons Team
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                        Version 3.10
-                        Release Notes
+Apache Commons Lang 3.10.0 Release Notes
+----------------------------------------
 
 
 INTRODUCTION:
@@ -940,11 +1089,10 @@ https://commons.apache.org/proper/commons-lang/
 
 Download page: https://commons.apache.org/proper/commons-lang/download_lang.cgi
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                            Version 3.9
-                           Release Notes
+Apache Commons Lang 3.9 Release Notes
+-------------------------------------
 
 
 INTRODUCTION:
@@ -991,11 +1139,10 @@ patches, or suggestions for improvement, see the Apache Commons Lang website:
 
 https://commons.apache.org/proper/commons-lang/
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                            Version 3.8.1
-                           Release Notes
+Apache Commons Lang 3.8.1 Release Notes
+----------------------------------------
 
 
 INTRODUCTION:
@@ -1022,11 +1169,10 @@ Changes in this version include:
 Fixed Bugs:
 o LANG-1419: Restore BundleSymbolicName for OSGi
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Apache Commons Lang
-                            Version 3.8
-                           Release Notes
+Apache Commons Lang 3.8 Release Notes
+-------------------------------------
 
 
 INTRODUCTION:
@@ -1081,12 +1227,10 @@ o LANG-1367: ObjectUtils.identityToString(Object) and friends should allocate bu
 o LANG-1405: Remove checks for java versions below the minimum supported one Thanks to Lars Grefer.
 o LANG-1402: Null/index safe get methods for ArrayUtils Thanks to Mark Dacek.
 
-=============================================================================
-
-                        Apache Commons Lang
-                            Version 3.7
-                           Release Notes
+-----------------------------------------------------------------------------
 
+Apache Commons Lang 3.7 Release Notes
+----------------------------------------
 
 INTRODUCTION:
 
@@ -1127,11 +1271,10 @@ o LANG-1346: Remove deprecation from RandomStringUtils
 o LANG-1361: ExceptionUtils.getThrowableList() is using deprecated ExceptionUtils.getCause() Thanks to Ana.
 
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                           Apache Commons Lang
-                               Version 3.6
-                              Release Notes
+Apache Commons Lang 3.6 Release Notes
+----------------------------------------
 
 
 INTRODUCTION:
@@ -1311,9 +1454,10 @@ o LANG-1301: Moving apache-rat-plugin configuration into pluginManagement.
              Thanks to Karl Heinz Marbaise.
 o LANG-1316: Deprecate classes/methods moved to commons-text.
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Release Notes for version 3.5
+Apache Commons Lang 3.5 Release Notes
+----------------------------------------
 
 
 HIGHLIGHTS
@@ -1610,10 +1754,10 @@ o LANG-1107: Fix parsing edge cases in FastDateParser.
 o LANG-1273: Added new property IS_OS_MAC_OSX_EL_CAPITAN in SystemUtils. Thanks
              to Jake Wang.
 
-=============================================================================
-
-                        Release Notes for version 3.4
+-----------------------------------------------------------------------------
 
+Apache Commons Lang 3.4 Release Notes
+-------------------------------------
 
 COMPATIBILITY
 =============
@@ -1746,9 +1890,10 @@ o LANG-1003: DurationFormatUtils are not able to handle negative
 o LANG-998:  Javadoc is not clear on preferred pattern to instantiate
              FastDateParser / FastDatePrinter
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Release Notes for version 3.3.2
+Apache Commons Lang 3.3.2 Release Notes
+---------------------------------------
 
 NEW FEATURES
 ==============
@@ -1760,9 +1905,10 @@ FIXED BUGS
 
 o LANG-992:  NumberUtils#isNumber() returns false for "0.0", "0.4790", et al
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Release Notes for version 3.3.1
+Apache Commons Lang 3.3.1 Release Notes
+---------------------------------------
 
 FIXED BUGS
 ============
@@ -1776,9 +1922,10 @@ o LANG-982:  DurationFormatUtils.formatDuration(61999, "s.SSSS") - ms field
              size should be 4 digits
 o LANG-978:  Failing tests with Java 8 b128
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Release Notes for version 3.3
+Apache Commons Lang 3.3 Release Notes
+-------------------------------------
 
 NEW FEATURES
 ==============
@@ -1843,9 +1990,10 @@ o LANG-953:  Convert package.html files to package-info.java files
 o LANG-940:  Fix deprecation warnings
 o LANG-819:  EnumUtils.generateBitVector needs a "? extends"
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Release Notes for version 3.2.1
+Apache Commons Lang 3.2.1 Release Notes
+---------------------------------------
 
 BUG FIXES
 ===========
@@ -1857,9 +2005,10 @@ o LANG-942:  Test failure in FastDateParserTest and FastDateFormat_ParserTest
              Henri Yandell.
 o LANG-938:  Build fails with test failures when building with JDK 8
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Release Notes for version 3.2
+Apache Commons Lang 3.2 Release Notes
+----------------------------------------
 
 COMPATIBILITY WITH 3.1
 ========================
@@ -2019,9 +2168,10 @@ CHANGES WITHOUT TICKET
 
 o Fixed URLs in javadoc to point to new oracle.com pages
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Release Notes for version 3.1
+Apache Commons Lang 3.1 Release Notes
+-------------------------------------
 
 NEW FEATURES
 ==============
@@ -2054,9 +2204,10 @@ o LANG-748:  Deprecating chomp(String, String)
 o LANG-736:  CharUtils static final array CHAR_STRING is not needed to compute
              CHAR_STRING_ARRAY
 
-=============================================================================
+-----------------------------------------------------------------------------
 
-                        Release Notes for version 3.0
+Apache Commons Lang 3.0 Release Notes
+-------------------------------------
 
 ADDITIONS
 ===========
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 7e8bc2440..7b5223869 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -44,7 +44,7 @@ The <action> type attribute can be add,update,fix,remove.
     <title>Apache Commons Lang Release Notes</title>
   </properties>
   <body>
-  <release version="3.18.0" date="YYYY-MM-DD" description="This is a feature and maintenance release. Java 8 or later is required.">
+  <release version="3.18.0" date="2025-07-04" description="This is a feature and maintenance release. Java 8 or later is required.">
     <!-- FIX -->
     <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Fix flaky FileUtilsWaitForTest.testWaitForNegativeDuration().</action>
     <action                   type="fix" dev="ggregory" due-to="Gary Gregory">Pick up exec-maven-plugin version from parent POM.</action>
diff --git a/src/site/xdoc/download_lang.xml b/src/site/xdoc/download_lang.xml
index 4113bab5e..be75682a0 100644
--- a/src/site/xdoc/download_lang.xml
+++ b/src/site/xdoc/download_lang.xml
@@ -56,10 +56,12 @@ limitations under the License.
  |                                                                      |
  +======================================================================+
 -->
-<document>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 https://maven.apache.org/xsd/xdoc-2.0.xsd">
   <properties>
     <title>Download Apache Commons Lang</title>
-    <author email="dev@commons.apache.org">Apache Commons Documentation Team</author>
+    <author email="dev@commons.apache.org">Apache Commons Team</author>
   </properties>
   <body>
     <section name="Download Apache Commons Lang">
@@ -79,7 +81,7 @@ limitations under the License.
         mirrors (at the end of the mirrors list) that should be
         available.
         <br></br>
-        [if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0"></img></a>[end]
+        [if-any logo]<a href="[link]"><img align="right" src="[logo]" border="0" alt="Logo"></img></a>[end]
       </p>
 
       <form action="[location]" method="get" id="SelectMirror">
@@ -113,32 +115,32 @@ limitations under the License.
       </p>
     </subsection>
     </section>
-    <section name="Apache Commons Lang 3.17.0 (Java 8+)">
+    <section name="Apache Commons Lang 3.18.0 (Java 8+)">
       <subsection name="Binaries">
         <table>
           <tr>
-              <td><a href="[preferred]/commons/lang/binaries/commons-lang3-3.17.0-bin.tar.gz">commons-lang3-3.17.0-bin.tar.gz</a></td>
-              <td><a href="https://downloads.apache.org/commons/lang/binaries/commons-lang3-3.17.0-bin.tar.gz.sha512">sha512</a></td>
-              <td><a href="https://downloads.apache.org/commons/lang/binaries/commons-lang3-3.17.0-bin.tar.gz.asc">pgp</a></td>
+              <td><a href="[preferred]/commons/lang/binaries/commons-lang3-3.18.0-bin.tar.gz">commons-lang3-3.18.0-bin.tar.gz</a></td>
+              <td><a href="https://downloads.apache.org/commons/lang/binaries/commons-lang3-3.18.0-bin.tar.gz.sha512">sha512</a></td>
+              <td><a href="https://downloads.apache.org/commons/lang/binaries/commons-lang3-3.18.0-bin.tar.gz.asc">pgp</a></td>
           </tr>
           <tr>
-              <td><a href="[preferred]/commons/lang/binaries/commons-lang3-3.17.0-bin.zip">commons-lang3-3.17.0-bin.zip</a></td>
-              <td><a href="https://downloads.apache.org/commons/lang/binaries/commons-lang3-3.17.0-bin.zip.sha512">sha512</a></td>
-              <td><a href="https://downloads.apache.org/commons/lang/binaries/commons-lang3-3.17.0-bin.zip.asc">pgp</a></td>
+              <td><a href="[preferred]/commons/lang/binaries/commons-lang3-3.18.0-bin.zip">commons-lang3-3.18.0-bin.zip</a></td>
+              <td><a href="https://downloads.apache.org/commons/lang/binaries/commons-lang3-3.18.0-bin.zip.sha512">sha512</a></td>
+              <td><a href="https://downloads.apache.org/commons/lang/binaries/commons-lang3-3.18.0-bin.zip.asc">pgp</a></td>
           </tr>
         </table>
       </subsection>
       <subsection name="Source">
         <table>
           <tr>
-              <td><a href="[preferred]/commons/lang/source/commons-lang3-3.17.0-src.tar.gz">commons-lang3-3.17.0-src.tar.gz</a></td>
-              <td><a href="https://downloads.apache.org/commons/lang/source/commons-lang3-3.17.0-src.tar.gz.sha512">sha512</a></td>
-              <td><a href="https://downloads.apache.org/commons/lang/source/commons-lang3-3.17.0-src.tar.gz.asc">pgp</a></td>
+              <td><a href="[preferred]/commons/lang/source/commons-lang3-3.18.0-src.tar.gz">commons-lang3-3.18.0-src.tar.gz</a></td>
+              <td><a href="https://downloads.apache.org/commons/lang/source/commons-lang3-3.18.0-src.tar.gz.sha512">sha512</a></td>
+              <td><a href="https://downloads.apache.org/commons/lang/source/commons-lang3-3.18.0-src.tar.gz.asc">pgp</a></td>
           </tr>
           <tr>
-              <td><a href="[preferred]/commons/lang/source/commons-lang3-3.17.0-src.zip">commons-lang3-3.17.0-src.zip</a></td>
-              <td><a href="https://downloads.apache.org/commons/lang/source/commons-lang3-3.17.0-src.zip.sha512">sha512</a></td>
-              <td><a href="https://downloads.apache.org/commons/lang/source/commons-lang3-3.17.0-src.zip.asc">pgp</a></td>
+              <td><a href="[preferred]/commons/lang/source/commons-lang3-3.18.0-src.zip">commons-lang3-3.18.0-src.zip</a></td>
+              <td><a href="https://downloads.apache.org/commons/lang/source/commons-lang3-3.18.0-src.zip.sha512">sha512</a></td>
+              <td><a href="https://downloads.apache.org/commons/lang/source/commons-lang3-3.18.0-src.zip.asc">pgp</a></td>
           </tr>
         </table>
       </subsection>
diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml
index 98729c9ae..b4906f431 100644
--- a/src/site/xdoc/issue-tracking.xml
+++ b/src/site/xdoc/issue-tracking.xml
@@ -41,10 +41,12 @@ limitations under the License.
  |                                                                      |
  +======================================================================+
 -->
-<document>
+<document xmlns="http://maven.apache.org/XDOC/2.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 https://maven.apache.org/xsd/xdoc-2.0.xsd">
   <properties>
     <title>Apache Commons Lang Issue tracking</title>
-    <author email="dev@commons.apache.org">Apache Commons Documentation Team</author>
+    <author email="dev@commons.apache.org">Apache Commons Team</author>
   </properties>
   <body>
 
@@ -64,6 +66,7 @@ limitations under the License.
       <p>
       If you would like to report a bug, or raise an enhancement request with
       Apache Commons Lang please do the following:
+      </p>
       <ol>
         <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310481&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">Search existing open bugs</a>.
             If you find your issue listed then please add a comment with your details.</li>
@@ -73,16 +76,15 @@ limitations under the License.
         <li>Submit either a <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310481&amp;issuetype=1&amp;priority=4&amp;assignee=-1">bug report</a>
             or <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310481&amp;issuetype=4&amp;priority=4&amp;assignee=-1">enhancement request</a>.</li>
       </ol>
-      </p>
 
       <p>
       Please also remember these points:
+      </p>
       <ul>
         <li>the more information you provide, the better we can help you</li>
         <li>test cases are vital, particularly for any proposed enhancements</li>
         <li>the developers of Apache Commons Lang are all unpaid volunteers</li>
       </ul>
-      </p>
 
       <p>
       For more information on creating patches see the
@@ -91,12 +93,12 @@ limitations under the License.
 
       <p>
       You may also find these links useful:
+      </p>
       <ul>
         <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310481&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">All Open Apache Commons Lang bugs</a></li>
         <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310481&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=5&amp;status=6">All Resolved Apache Commons Lang bugs</a></li>
         <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310481&amp;sorter/field=issuekey&amp;sorter/order=DESC">All Apache Commons Lang bugs</a></li>
       </ul>
-      </p>
     </section>
   </body>
 </document>
diff --git a/src/site/xdoc/mail-lists.xml b/src/site/xdoc/mail-lists.xml
index 0c28ab697..687cf14a1 100644
--- a/src/site/xdoc/mail-lists.xml
+++ b/src/site/xdoc/mail-lists.xml
@@ -44,7 +44,7 @@ limitations under the License.
   xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 https://maven.apache.org/xsd/xdoc-2.0.xsd">
   <properties>
     <title>Apache Commons Lang Mailing Lists</title>
-    <author email="dev@commons.apache.org">Apache Commons Documentation Team</author>
+    <author email="dev@commons.apache.org">Apache Commons Team</author>
   </properties>
   <body>