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

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


The following commit(s) were added to refs/heads/POOL_2_X by this push:
     new f8d7bedc Prepare for the next release candidate
f8d7bedc is described below

commit f8d7bedc2981b4e0608cdf350faae08b1d8050a9
Author: Gary D. Gregory <[email protected]>
AuthorDate: Mon Jan 20 13:31:19 2025 +0000

    Prepare for the next release candidate
---
 CONTRIBUTING.md                  | 16 ++++----
 README.md                        | 87 ++++++++++------------------------------
 RELEASE-NOTES.txt                | 50 +++++++++++++++++++++++
 pom.xml                          |  8 ++--
 src/changes/changes.xml          |  3 +-
 src/changes/release-notes.vm     |  5 ++-
 src/site/xdoc/download_pool.xml  | 34 ++++++++--------
 src/site/xdoc/issue-tracking.xml | 14 ++++---
 src/site/xdoc/mail-lists.xml     | 52 ++++++++++++------------
 9 files changed, 140 insertions(+), 129 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 5814970d..20ce6095 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -6,7 +6,7 @@
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at
 
-      http://www.apache.org/licenses/LICENSE-2.0
+      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,
@@ -41,28 +41,27 @@
 Contributing to Apache Commons Pool
 ======================
 
-You have found a bug or you have an idea for a cool new feature? Contributing 
code is a great way to give something back to
-the open source community. Before you dig right into the code there are a few 
guidelines that we need contributors to
-follow so that we can have a chance of keeping on top of things.
+Have you found a bug or have an idea for a cool new feature? Contributing code 
is a great way to give something back to the open-source community.
+Before you dig right into the code, we need contributors to follow a few 
guidelines to have a chance of keeping on top of things.
 
 Getting Started
 ---------------
 
 + Make sure you have a [JIRA account](https://issues.apache.org/jira/).
-+ Make sure you have a [GitHub account](https://github.com/signup/free).
++ Make sure you have a [GitHub account](https://github.com/signup/free). This 
is not essential, but makes providing patches much easier.
 + If you're planning to implement a new feature it makes sense to discuss your 
changes on the [dev list](https://commons.apache.org/mail-lists.html) first. 
This way you can make sure you're not wasting your time on something that isn't 
considered to be in Apache Commons Pool's scope.
 + Submit a [Jira Ticket][jira] for your issue, assuming one does not already 
exist.
   + Clearly describe the issue including steps to reproduce when it is a bug.
   + Make sure you fill in the earliest version that you know has the issue.
 + Find the corresponding [repository on 
GitHub](https://github.com/apache/?query=commons-),
-[fork](https://help.github.com/articles/fork-a-repo/) and check out your 
forked repository.
+[fork](https://help.github.com/articles/fork-a-repo/) and check out your 
forked repository. If you don't have a GitHub account, you can still clone the 
Commons repository.
 
 Making Changes
 --------------
 
 + Create a _topic branch_ for your isolated work.
   * Usually you should base your branch on the `master` branch.
-  * A good topic branch name can be the JIRA bug id plus a keyword, e.g. 
`POOL-123-InputStream`.
+  * A good topic branch name can be the JIRA bug ID plus a keyword, e.g. 
`POOL-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.
@@ -72,7 +71,7 @@ Making Changes
   + 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.
   + Check for unnecessary whitespace with `git diff` -- check before 
committing.
 + Make sure you have added the necessary tests for your changes, typically in 
`src/test/java`.
-+ Run all the tests with `mvn clean verify` to assure nothing else was 
accidentally broken.
++ Run all the tests with `mvn clean verify` to ensure nothing else was 
accidentally broken.
 
 Making Trivial Changes
 ----------------------
@@ -109,7 +108,6 @@ Additional Resources
 + [General GitHub documentation](https://help.github.com/)
 + [GitHub pull request 
documentation](https://help.github.com/articles/creating-a-pull-request/)
 + [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
-+ `#apache-commons` IRC channel on `irc.freenode.net`
 
 [cla]:https://www.apache.org/licenses/#clas
 [jira]:https://issues.apache.org/jira/browse/POOL
diff --git a/README.md b/README.md
index 2f0488d1..b33d81f6 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at
 
-      http://www.apache.org/licenses/LICENSE-2.0
+      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,
@@ -43,10 +43,10 @@
 Apache Commons Pool
 ===================
 
-[![GitHub Actions 
Status](https://github.com/apache/commons-pool/workflows/Java%20CI/badge.svg)](https://github.com/apache/commons-pool/actions)
+[![Java 
CI](https://github.com/apache/commons-pool/actions/workflows/maven.yml/badge.svg)](https://github.com/apache/commons-pool/actions/workflows/maven.yml)
 [![Maven 
Central](https://img.shields.io/maven-central/v/org.apache.commons/commons-pool2?label=Maven%20Central)](https://search.maven.org/artifact/org.apache.commons/commons-pool2)
-[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-pool2/2.12.0.svg)](https://javadoc.io/doc/org.apache.commons/commons-pool2/2.12.0)
-[![CodeQL](https://github.com/apache/commons-pool/workflows/CodeQL/badge.svg)](https://github.com/apache/commons-pool/actions/workflows/codeql-analysis.yml?query=workflow%3ACodeQL)
+[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-pool2/2.12.1.svg)](https://javadoc.io/doc/org.apache.commons/commons-pool2/2.12.1)
+[![CodeQL](https://github.com/apache/commons-pool/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/apache/commons-pool/actions/workflows/codeql-analysis.yml)
 [![OpenSSF 
Scorecard](https://api.securityscorecards.dev/projects/github.com/apache/commons-pool/badge)](https://api.securityscorecards.dev/projects/github.com/apache/commons-pool)
 
 The Apache Commons Object Pooling Library.
@@ -58,27 +58,35 @@ More information can be found on the [Apache Commons Pool 
homepage](https://comm
 The [Javadoc](https://commons.apache.org/proper/commons-pool/apidocs) can be 
browsed.
 Questions related to the usage of Apache Commons Pool should be posted to the 
[user mailing list](https://commons.apache.org/mail-lists.html).
 
-Where can I get the latest release?
------------------------------------
+Getting the latest release
+--------------------------
 You can download source and binaries from our [download 
page](https://commons.apache.org/proper/commons-pool/download_pool.cgi).
 
-Alternatively, you can pull it from  the central Maven repositories:
+Alternatively, you can pull it from the central Maven repositories:
 
 ```xml
 <dependency>
   <groupId>org.apache.commons</groupId>
   <artifactId>commons-pool2</artifactId>
-  <version>2.12.0</version>
+  <version>2.12.1</version>
 </dependency>
 ```
 
+Building
+--------
+
+Building requires a Java JDK and [Apache Maven](https://maven.apache.org/).
+The required Java version is found in the `pom.xml` as the 
`maven.compiler.source` property.
+
+From a command shell, run `mvn` without arguments to invoke the default Maven 
goal to run all tests and checks.
+
 Contributing
 ------------
 
 We accept Pull Requests via GitHub. The [developer mailing 
list](https://commons.apache.org/mail-lists.html) is the main channel of 
communication for contributors.
 There are some guidelines which will make applying PRs easier for us:
 + No tabs! Please use spaces for indentation.
-+ Respect the code style.
++ Respect the existing code style for each file.
 + 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.
@@ -89,13 +97,13 @@ You can learn more about contributing via GitHub in our 
[contribution guidelines
 
 License
 -------
-This code is under the [Apache Licence 
v2](https://www.apache.org/licenses/LICENSE-2.0).
+This code is licensed under the [Apache License 
v2](https://www.apache.org/licenses/LICENSE-2.0).
 
 See the `NOTICE.txt` file for required notices and attributions.
 
-Donations
----------
-You like Apache Commons Pool? Then [donate back to the 
ASF](https://www.apache.org/foundation/contributing.html) to support the 
development.
+Donating
+--------
+You like Apache Commons Pool? Then [donate back to the 
ASF](https://www.apache.org/foundation/contributing.html) to support 
development.
 
 Additional Resources
 --------------------
@@ -104,59 +112,8 @@ Additional Resources
 + [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/POOL)
 + [Apache Commons Slack Channel](https://the-asf.slack.com/archives/C60NVB8AD)
 + [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
-+ `#apache-commons` IRC channel on `irc.freenode.org`
 
 Apache Commons Components
 -------------------------
 
-| Component | GitHub Repository | Apache Homepage |
-| --------- | ----------------- | ----------------|
-| Apache Commons BCEL | [commons-bcel](https://github.com/apache/commons-bcel) 
| [commons-bcel](https://commons.apache.org/proper/commons-bcel) |
-| Apache Commons Beanutils | 
[commons-beanutils](https://github.com/apache/commons-beanutils) | 
[commons-beanutils](https://commons.apache.org/proper/commons-beanutils) |
-| Apache Commons BSF | [commons-bsf](https://github.com/apache/commons-bsf) | 
[commons-bsf](https://commons.apache.org/proper/commons-bsf) |
-| Apache Commons Build-plugin | 
[commons-build-plugin](https://github.com/apache/commons-build-plugin) | 
[commons-build-plugin](https://commons.apache.org/proper/commons-build-plugin) |
-| Apache Commons Chain | 
[commons-chain](https://github.com/apache/commons-chain) | 
[commons-chain](https://commons.apache.org/proper/commons-chain) |
-| Apache Commons CLI | [commons-cli](https://github.com/apache/commons-cli) | 
[commons-cli](https://commons.apache.org/proper/commons-cli) |
-| Apache Commons Codec | 
[commons-codec](https://github.com/apache/commons-codec) | 
[commons-codec](https://commons.apache.org/proper/commons-codec) |
-| Apache Commons Collections | 
[commons-collections](https://github.com/apache/commons-collections) | 
[commons-collections](https://commons.apache.org/proper/commons-collections) |
-| Apache Commons Compress | 
[commons-compress](https://github.com/apache/commons-compress) | 
[commons-compress](https://commons.apache.org/proper/commons-compress) |
-| Apache Commons Configuration | 
[commons-configuration](https://github.com/apache/commons-configuration) | 
[commons-configuration](https://commons.apache.org/proper/commons-configuration)
 |
-| Apache Commons Crypto | 
[commons-crypto](https://github.com/apache/commons-crypto) | 
[commons-crypto](https://commons.apache.org/proper/commons-crypto) |
-| Apache Commons CSV | [commons-csv](https://github.com/apache/commons-csv) | 
[commons-csv](https://commons.apache.org/proper/commons-csv) |
-| Apache Commons Daemon | 
[commons-daemon](https://github.com/apache/commons-daemon) | 
[commons-daemon](https://commons.apache.org/proper/commons-daemon) |
-| Apache Commons DBCP | [commons-dbcp](https://github.com/apache/commons-dbcp) 
| [commons-dbcp](https://commons.apache.org/proper/commons-dbcp) |
-| Apache Commons Dbutils | 
[commons-dbutils](https://github.com/apache/commons-dbutils) | 
[commons-dbutils](https://commons.apache.org/proper/commons-dbutils) |
-| Apache Commons Digester | 
[commons-digester](https://github.com/apache/commons-digester) | 
[commons-digester](https://commons.apache.org/proper/commons-digester) |
-| Apache Commons Email | 
[commons-email](https://github.com/apache/commons-email) | 
[commons-email](https://commons.apache.org/proper/commons-email) |
-| Apache Commons Exec | [commons-exec](https://github.com/apache/commons-exec) 
| [commons-exec](https://commons.apache.org/proper/commons-exec) |
-| Apache Commons Fileupload | 
[commons-fileupload](https://github.com/apache/commons-fileupload) | 
[commons-fileupload](https://commons.apache.org/proper/commons-fileupload) |
-| Apache Commons Functor | 
[commons-functor](https://github.com/apache/commons-functor) | 
[commons-functor](https://commons.apache.org/proper/commons-functor) |
-| Apache Commons Geometry | 
[commons-geometry](https://github.com/apache/commons-geometry) | 
[commons-geometry](https://commons.apache.org/proper/commons-geometry) |
-| Apache Commons Graph | 
[commons-graph](https://github.com/apache/commons-graph) | 
[commons-graph](https://commons.apache.org/proper/commons-graph) |
-| Apache Commons Imaging | 
[commons-imaging](https://github.com/apache/commons-imaging) | 
[commons-imaging](https://commons.apache.org/proper/commons-imaging) |
-| Apache Commons IO | [commons-io](https://github.com/apache/commons-io) | 
[commons-io](https://commons.apache.org/proper/commons-io) |
-| Apache Commons JCI | [commons-jci](https://github.com/apache/commons-jci) | 
[commons-jci](https://commons.apache.org/proper/commons-jci) |
-| Apache Commons JCS | [commons-jcs](https://github.com/apache/commons-jcs) | 
[commons-jcs](https://commons.apache.org/proper/commons-jcs) |
-| Apache Commons Jelly | 
[commons-jelly](https://github.com/apache/commons-jelly) | 
[commons-jelly](https://commons.apache.org/proper/commons-jelly) |
-| Apache Commons Jexl | [commons-jexl](https://github.com/apache/commons-jexl) 
| [commons-jexl](https://commons.apache.org/proper/commons-jexl) |
-| Apache Commons Jxpath | 
[commons-jxpath](https://github.com/apache/commons-jxpath) | 
[commons-jxpath](https://commons.apache.org/proper/commons-jxpath) |
-| Apache Commons Lang | [commons-lang](https://github.com/apache/commons-lang) 
| [commons-lang](https://commons.apache.org/proper/commons-lang) |
-| Apache Commons Logging | 
[commons-logging](https://github.com/apache/commons-logging) | 
[commons-logging](https://commons.apache.org/proper/commons-logging) |
-| Apache Commons Math | [commons-math](https://github.com/apache/commons-math) 
| [commons-math](https://commons.apache.org/proper/commons-math) |
-| Apache Commons Net | [commons-net](https://github.com/apache/commons-net) | 
[commons-net](https://commons.apache.org/proper/commons-net) |
-| Apache Commons Numbers | 
[commons-numbers](https://github.com/apache/commons-numbers) | 
[commons-numbers](https://commons.apache.org/proper/commons-numbers) |
-| Apache Commons Parent | 
[commons-parent](https://github.com/apache/commons-parent) | 
[commons-parent](https://commons.apache.org/proper/commons-parent) |
-| Apache Commons Pool | [commons-pool](https://github.com/apache/commons-pool) 
| [commons-pool](https://commons.apache.org/proper/commons-pool) |
-| Apache Commons Proxy | 
[commons-proxy](https://github.com/apache/commons-proxy) | 
[commons-proxy](https://commons.apache.org/proper/commons-proxy) |
-| Apache Commons RDF | [commons-rdf](https://github.com/apache/commons-rdf) | 
[commons-rdf](https://commons.apache.org/proper/commons-rdf) |
-| Apache Commons Release-plugin | 
[commons-release-plugin](https://github.com/apache/commons-release-plugin) | 
[commons-release-plugin](https://commons.apache.org/proper/commons-release-plugin)
 |
-| Apache Commons Rng | [commons-rng](https://github.com/apache/commons-rng) | 
[commons-rng](https://commons.apache.org/proper/commons-rng) |
-| Apache Commons Scxml | 
[commons-scxml](https://github.com/apache/commons-scxml) | 
[commons-scxml](https://commons.apache.org/proper/commons-scxml) |
-| Apache Commons Signing | 
[commons-signing](https://github.com/apache/commons-signing) | 
[commons-signing](https://commons.apache.org/proper/commons-signing) |
-| Apache Commons Skin | [commons-skin](https://github.com/apache/commons-skin) 
| [commons-skin](https://commons.apache.org/proper/commons-skin) |
-| Apache Commons Statistics | 
[commons-statistics](https://github.com/apache/commons-statistics) | 
[commons-statistics](https://commons.apache.org/proper/commons-statistics) |
-| Apache Commons Testing | 
[commons-testing](https://github.com/apache/commons-testing) | 
[commons-testing](https://commons.apache.org/proper/commons-testing) |
-| Apache Commons Text | [commons-text](https://github.com/apache/commons-text) 
| [commons-text](https://commons.apache.org/proper/commons-text) |
-| Apache Commons Validator | 
[commons-validator](https://github.com/apache/commons-validator) | 
[commons-validator](https://commons.apache.org/proper/commons-validator) |
-| Apache Commons VFS | [commons-vfs](https://github.com/apache/commons-vfs) | 
[commons-vfs](https://commons.apache.org/proper/commons-vfs) |
-| Apache Commons Weaver | 
[commons-weaver](https://github.com/apache/commons-weaver) | 
[commons-weaver](https://commons.apache.org/proper/commons-weaver) |
+Please see the [list of components](https://commons.apache.org/components.html)
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index b9141be2..859a8361 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,3 +1,53 @@
+Apache Commons Pool 2.12.1 Release Notes
+----------------------------------------
+
+The Apache Commons Pool team is pleased to announce the release of Apache 
Commons Pool 2.12.1.
+
+Apache Commons Pool provides an object-pooling API and a number of object pool 
implementations.
+Version 2 contains a completely re-written pooling implementation compared to 
the 1.x series.
+In addition to performance and scalability improvements, version 2 includes 
robust instance
+tracking and pool monitoring. 
+
+Version 2.7.x and up requires Java 8 or above.
+Version 2.6.x requires Java 7 or above.
+Version 2.5.x requires Java 7 or above.
+Version 2.0 requires 6 or above. 
+
+NOTE: The MBean interfaces (DefaultPooledObjectInfoMBean, 
GenericKeyedObjectPoolMXBean
+      and GenericKeyedObjectPoolMXBean) exist only to define the attributes 
and methods
+      that will be made available via JMX. They must not be implemented by 
clients as
+      they are subject to change between major, minor and patch version 
releases of
+      Commons Pool. Clients that implement any of these interfaces may not, 
therefore,
+      be able to upgrade to a new minor or patch release without requiring code
+      changes.
+
+${d}
+
+Changes in version 2.12.1 include:
+
+
+Fixed Bugs:
+o            Use java.time.Instant precision in 
org.apache.commons.pool2.impl.ThrowableCallStack.Snapshot throwable message. 
Thanks to Gary Gregory.
+o            GenericObjectPool.borrowObject(Duration) doesn't obey its 
borrowMaxWait Duration argument when the argument is different from 
GenericObjectPool.getMaxWaitDuration(). Thanks to Gary Gregory.
+o POOL-418:  The maximum wait time for GenericObjectPool.borrowObject(*) may 
exceed expectations due to a spurious thread wakeup. Thanks to Gary Gregory.
+o            Javadoc is missing its Overview page. Thanks to Gary Gregory.
+o            Migrate site generation templates to 
https://maven.apache.org/xsd/xdoc-2.0.xsd. Thanks to Gary Gregory.
+
+Changes:
+o            Bump org.apache.commons:commons-parent from 62 to 79. Thanks to 
Gary Gregory.
+o            [test] Bump commons-lang3 from 3.13.0 to 3.17.0. Thanks to Gary 
Gregory.
+o            [site] Pickup org.apache.bcel:bcel version from parent POM. 
Thanks to Gary Gregory.
+o            [test] Bump org.ow2.asm:asm-util from 9.5 to 9.7.1. Thanks to 
Gary Gregory.
+
+
+For complete information on Apache Commons Pool, including instructions on how 
to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons Pool website:
+
+https://commons.apache.org/proper/commons-pool/
+
+Download page: https://commons.apache.org/proper/commons-pool/download_pool.cgi
+
+-----------------------------------------------------------------------------------------------
               Apache Commons Pool 2.12.0 RELEASE NOTES
 
 The Apache Commons Pool team is pleased to announce the release of Apache 
Commons Pool 2.12.0.
diff --git a/pom.xml b/pom.xml
index 4d41a4bc..5e34abc5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -85,26 +85,26 @@
     
<project.build.outputTimestamp>2024-02-01T03:27:02Z</project.build.outputTimestamp>
     <maven.compiler.source>1.8</maven.compiler.source>
     <maven.compiler.target>1.8</maven.compiler.target>
+    <commons.main.branch>POOL_2_X</commons.main.branch>
+    <commons.release.branch>release-2.x</commons.release.branch>
     <commons.componentid>pool</commons.componentid>
     <commons.module.name>org.apache.commons.pool2</commons.module.name>
     <commons.rc.version>RC1</commons.rc.version>
+    
     <!-- Java 8 -->
     <commons.release.version>2.12.1</commons.release.version>
-    <commons.release.version>2.12.2</commons.release.version>
+    <commons.release.next>2.12.2</commons.release.next>
     <commons.release.desc>(Java 8 or above)</commons.release.desc>
     <!-- Java 7 -->
     <commons.release.2.version>2.6.2</commons.release.2.version>
     <commons.release.2.desc>(Java 7 or above)</commons.release.2.desc>
-
     <commons.jira.id>POOL</commons.jira.id>
     <commons.jira.pid>12310488</commons.jira.pid>
     
<commons.scmPubCheckoutDirectory>site-content</commons.scmPubCheckoutDirectory>
     
<commons.osgi.import>net.sf.cglib.proxy;resolution:=optional,*</commons.osgi.import>
-
     <!-- Commons Release Plugin -->
     <commons.bc.version>2.12.0</commons.bc.version>
     <commons.release.isDistModule>true</commons.release.isDistModule>
-    
     <japicmp.skip>false</japicmp.skip>
     <spotbugs.skip>false</spotbugs.skip>
     <surefire.argline></surefire.argline>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index bdedf39e..3b0b09c4 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -45,12 +45,13 @@ The <action> type attribute can be add,update,fix,remove.
     <title>Apache Commons Pool Release Notes</title>
   </properties>
   <body>
-  <release version="2.12.1" date="YYYY-MM-DD" description="This is a feature 
and maintenance release (Java 8 or above).">
+  <release version="2.12.1" date="2025-01-19" description="This is a feature 
and maintenance release (Java 8 or above).">
     <!-- FIX -->
     <action type="fix" dev="ggregory" due-to="Gary Gregory">Use 
java.time.Instant precision in 
org.apache.commons.pool2.impl.ThrowableCallStack.Snapshot throwable 
message.</action> 
     <action type="fix" dev="ggregory" due-to="Gary 
Gregory">GenericObjectPool.borrowObject(Duration) doesn't obey its 
borrowMaxWait Duration argument when the argument is different from 
GenericObjectPool.getMaxWaitDuration().</action>
     <action type="fix" issue="POOL-418" dev="ggregory" due-to="Gary 
Gregory">The maximum wait time for GenericObjectPool.borrowObject(*) may exceed 
expectations due to a spurious thread wakeup.</action>
     <action type="fix" dev="ggregory" due-to="Gary Gregory">Javadoc is missing 
its Overview page.</action>
+    <action type="fix" dev="ggregory" due-to="Gary Gregory">Migrate site 
generation templates to https://maven.apache.org/xsd/xdoc-2.0.xsd.</action> 
     <!-- ADD -->
     <!-- UPDATE -->
     <action type="update" dev="ggregory" due-to="Gary Gregory">Bump 
org.apache.commons:commons-parent from 62 to 79.</action>
diff --git a/src/changes/release-notes.vm b/src/changes/release-notes.vm
index e4b3356a..29b59c8d 100644
--- a/src/changes/release-notes.vm
+++ b/src/changes/release-notes.vm
@@ -14,7 +14,8 @@
 ## KIND, either express or implied.  See the License for the
 ## specific language governing permissions and limitations
 ## under the License.
-              ${project.name} ${version} RELEASE NOTES
+${project.name} ${version} Release Notes
+----------------------------------------
 
 The ${developmentTeam} is pleased to announce the release of ${project.name} 
${version}.
 
@@ -41,7 +42,7 @@ NOTE: The MBean interfaces (DefaultPooledObjectInfoMBean, 
GenericKeyedObjectPool
 ##
 ## Hack to get line breaks to work in release description. For this to work, 
each line break in the
 ## release description attribute in changes.xml needs to be preceded by a 
single space.
-#set( $desc = $release.description )
+#set( $desc = $commons.release.desc )
 #set( $desc2 = $desc.replace($esc.newline, "  ") )
 #set( $d = $desc2.replace("  ",$esc.newline) )
 ${d}
diff --git a/src/site/xdoc/download_pool.xml b/src/site/xdoc/download_pool.xml
index adfbb71d..a1ce1c98 100644
--- a/src/site/xdoc/download_pool.xml
+++ b/src/site/xdoc/download_pool.xml
@@ -7,7 +7,7 @@ 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
 
-     http://www.apache.org/licenses/LICENSE-2.0
+     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,
@@ -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 Pool</title>
-    <author email="[email protected]">Apache Commons Documentation 
Team</author>
+    <author email="[email protected]">Apache Commons Team</author>
   </properties>
   <body>
     <section name="Download Apache Commons Pool">
@@ -113,32 +115,32 @@ limitations under the License.
       </p>
     </subsection>
     </section>
-    <section name="Apache Commons Pool 2.12.0 (Java 8 or above)">
+    <section name="Apache Commons Pool 2.12.1 (Java 8 or above)">
       <subsection name="Binaries">
         <table>
           <tr>
-              <td><a 
href="[preferred]/commons/pool/binaries/commons-pool2-2.12.0-bin.tar.gz">commons-pool2-2.12.0-bin.tar.gz</a></td>
-              <td><a 
href="https://downloads.apache.org/commons/pool/binaries/commons-pool2-2.12.0-bin.tar.gz.sha512";>sha512</a></td>
-              <td><a 
href="https://downloads.apache.org/commons/pool/binaries/commons-pool2-2.12.0-bin.tar.gz.asc";>pgp</a></td>
+              <td><a 
href="[preferred]/commons/pool/binaries/commons-pool2-2.12.1-bin.tar.gz">commons-pool2-2.12.1-bin.tar.gz</a></td>
+              <td><a 
href="https://downloads.apache.org/commons/pool/binaries/commons-pool2-2.12.1-bin.tar.gz.sha512";>sha512</a></td>
+              <td><a 
href="https://downloads.apache.org/commons/pool/binaries/commons-pool2-2.12.1-bin.tar.gz.asc";>pgp</a></td>
           </tr>
           <tr>
-              <td><a 
href="[preferred]/commons/pool/binaries/commons-pool2-2.12.0-bin.zip">commons-pool2-2.12.0-bin.zip</a></td>
-              <td><a 
href="https://downloads.apache.org/commons/pool/binaries/commons-pool2-2.12.0-bin.zip.sha512";>sha512</a></td>
-              <td><a 
href="https://downloads.apache.org/commons/pool/binaries/commons-pool2-2.12.0-bin.zip.asc";>pgp</a></td>
+              <td><a 
href="[preferred]/commons/pool/binaries/commons-pool2-2.12.1-bin.zip">commons-pool2-2.12.1-bin.zip</a></td>
+              <td><a 
href="https://downloads.apache.org/commons/pool/binaries/commons-pool2-2.12.1-bin.zip.sha512";>sha512</a></td>
+              <td><a 
href="https://downloads.apache.org/commons/pool/binaries/commons-pool2-2.12.1-bin.zip.asc";>pgp</a></td>
           </tr>
         </table>
       </subsection>
       <subsection name="Source">
         <table>
           <tr>
-              <td><a 
href="[preferred]/commons/pool/source/commons-pool2-2.12.0-src.tar.gz">commons-pool2-2.12.0-src.tar.gz</a></td>
-              <td><a 
href="https://downloads.apache.org/commons/pool/source/commons-pool2-2.12.0-src.tar.gz.sha512";>sha512</a></td>
-              <td><a 
href="https://downloads.apache.org/commons/pool/source/commons-pool2-2.12.0-src.tar.gz.asc";>pgp</a></td>
+              <td><a 
href="[preferred]/commons/pool/source/commons-pool2-2.12.1-src.tar.gz">commons-pool2-2.12.1-src.tar.gz</a></td>
+              <td><a 
href="https://downloads.apache.org/commons/pool/source/commons-pool2-2.12.1-src.tar.gz.sha512";>sha512</a></td>
+              <td><a 
href="https://downloads.apache.org/commons/pool/source/commons-pool2-2.12.1-src.tar.gz.asc";>pgp</a></td>
           </tr>
           <tr>
-              <td><a 
href="[preferred]/commons/pool/source/commons-pool2-2.12.0-src.zip">commons-pool2-2.12.0-src.zip</a></td>
-              <td><a 
href="https://downloads.apache.org/commons/pool/source/commons-pool2-2.12.0-src.zip.sha512";>sha512</a></td>
-              <td><a 
href="https://downloads.apache.org/commons/pool/source/commons-pool2-2.12.0-src.zip.asc";>pgp</a></td>
+              <td><a 
href="[preferred]/commons/pool/source/commons-pool2-2.12.1-src.zip">commons-pool2-2.12.1-src.zip</a></td>
+              <td><a 
href="https://downloads.apache.org/commons/pool/source/commons-pool2-2.12.1-src.zip.sha512";>sha512</a></td>
+              <td><a 
href="https://downloads.apache.org/commons/pool/source/commons-pool2-2.12.1-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 4137eff3..ee99de56 100644
--- a/src/site/xdoc/issue-tracking.xml
+++ b/src/site/xdoc/issue-tracking.xml
@@ -7,7 +7,7 @@ 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
 
-     http://www.apache.org/licenses/LICENSE-2.0
+     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,
@@ -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 Pool Issue tracking</title>
-    <author email="[email protected]">Apache Commons Documentation 
Team</author>
+    <author email="[email protected]">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 Pool please do the following:
+      </p>
       <ol>
         <li><a 
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310488&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=12310488&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=12310488&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 Pool 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=12310488&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4";>All
 Open Apache Commons Pool bugs</a></li>
         <li><a 
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310488&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=5&amp;status=6";>All
 Resolved Apache Commons Pool bugs</a></li>
         <li><a 
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310488&amp;sorter/field=issuekey&amp;sorter/order=DESC";>All
 Apache Commons Pool 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 030956f3..59156542 100644
--- a/src/site/xdoc/mail-lists.xml
+++ b/src/site/xdoc/mail-lists.xml
@@ -7,7 +7,7 @@ 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
 
-     http://www.apache.org/licenses/LICENSE-2.0
+     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,
@@ -39,10 +39,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 Pool Mailing Lists</title>
-    <author email="[email protected]">Apache Commons Documentation 
Team</author>
+    <author email="[email protected]">Apache Commons Team</author>
   </properties>
   <body>
 
@@ -53,15 +55,15 @@ limitations under the License.
         To make it easier for people to only read messages related to 
components they are interested in,
         the convention in Commons is to prefix the subject line of messages 
with the component's name,
         for example:
-        <ul>
-          <li>[pool] Problem with the ...</li>
-        </ul>
       </p>
+      <ul>
+        <li>[pool] Problem with the ...</li>
+      </ul>
       <p>
         Questions related to the usage of Apache Commons Pool should be posted 
to the
-        <a href="https://mail-archives.apache.org/mod_mbox/commons-user/";>User 
List</a>.
+        <a 
href="https://lists.apache.org/[email protected]";>User List</a>.
         <br />
-        The <a 
href="https://mail-archives.apache.org/mod_mbox/commons-dev/";>Developer List</a>
+        The <a 
href="https://lists.apache.org/[email protected]";>Developer 
List</a>
         is for questions and discussion related to the development of Apache 
Commons Pool.
         <br />
         Please do not cross-post; developers are also subscribed to the user 
list.
@@ -70,8 +72,10 @@ limitations under the License.
         to subscribe.
       </p>
       <p>
-        <strong>Note:</strong> please don't send patches or attachments to any 
of the mailing lists.
+        <strong>Note:</strong> please don't send patches or attachments to any 
of the mailing lists;
+        most of the lists are set up to drop attachments.
         Patches are best handled via the <a href="issue-tracking.html">Issue 
Tracking</a> system.
+        If you have a GitHub account, most components also accept PRs (pull 
requests).
         Otherwise, please upload the file to a public server and include the 
URL in the mail.
       </p>
     </section>
@@ -105,12 +109,11 @@ limitations under the License.
           <td><a 
href="mailto:[email protected]";>Subscribe</a></td>
           <td><a 
href="mailto:[email protected]";>Unsubscribe</a></td>
           <td><a 
href="mailto:[email protected]?subject=[pool]";>Post</a></td>
-          <td><a 
href="https://mail-archives.apache.org/mod_mbox/commons-user/";>mail-archives.apache.org</a><br
 />
+          <td>
               <a 
href="https://lists.apache.org/[email protected]";>lists.apache.org</a>
           </td>
-          <td><a 
href="https://markmail.org/list/org.apache.commons.users/";>markmail.org</a><br 
/>
-              <a 
href="https://www.mail-archive.com/[email protected]/";>www.mail-archive.com</a><br
 />
-              <a 
href="https://news.gmane.org/gmane.comp.jakarta.commons.devel";>news.gmane.org</a>
+          <td>
+              <a 
href="https://www.mail-archive.com/[email protected]/";>www.mail-archive.com</a>
           </td>
         </tr>
 
@@ -125,12 +128,11 @@ limitations under the License.
           <td><a 
href="mailto:[email protected]";>Subscribe</a></td>
           <td><a 
href="mailto:[email protected]";>Unsubscribe</a></td>
           <td><a 
href="mailto:[email protected]?subject=[pool]";>Post</a></td>
-          <td><a 
href="https://mail-archives.apache.org/mod_mbox/commons-dev/";>mail-archives.apache.org</a><br
 />
+          <td>
               <a 
href="https://lists.apache.org/[email protected]";>lists.apache.org</a>
           </td>
-          <td><a 
href="https://markmail.org/list/org.apache.commons.dev/";>markmail.org</a><br />
-              <a 
href="https://www.mail-archive.com/[email protected]/";>www.mail-archive.com</a><br
 />
-              <a 
href="https://news.gmane.org/gmane.comp.jakarta.commons.devel";>news.gmane.org</a>
+          <td>
+              <a 
href="https://www.mail-archive.com/[email protected]/";>www.mail-archive.com</a>
           </td>
         </tr>
 
@@ -145,10 +147,10 @@ limitations under the License.
           <td><a 
href="mailto:[email protected]";>Subscribe</a></td>
           <td><a 
href="mailto:[email protected]";>Unsubscribe</a></td>
           <td><i>read only</i></td>
-          <td><a 
href="https://mail-archives.apache.org/mod_mbox/commons-issues/";>mail-archives.apache.org</a><br
 />
+          <td>
               <a 
href="https://lists.apache.org/[email protected]";>lists.apache.org</a>
           </td>
-          <td><a 
href="https://markmail.org/list/org.apache.commons.issues/";>markmail.org</a><br 
/>
+          <td>
               <a 
href="https://www.mail-archive.com/[email protected]/";>www.mail-archive.com</a>
           </td>
         </tr>
@@ -164,10 +166,10 @@ limitations under the License.
           <td><a 
href="mailto:[email protected]";>Subscribe</a></td>
           <td><a 
href="mailto:[email protected]";>Unsubscribe</a></td>
           <td><i>read only</i></td>
-          <td><a 
href="https://mail-archives.apache.org/mod_mbox/commons-commits/";>mail-archives.apache.org</a><br
 />
+          <td>
               <a 
href="https://lists.apache.org/[email protected]";>lists.apache.org</a>
           </td>
-          <td><a 
href="https://markmail.org/list/org.apache.commons.commits/";>markmail.org</a><br
 />
+          <td>
               <a 
href="https://www.mail-archive.com/[email protected]/";>www.mail-archive.com</a>
           </td>
         </tr>
@@ -199,13 +201,11 @@ limitations under the License.
           <td><a class="externalLink" 
href="mailto:[email protected]";>Subscribe</a></td>
           <td><a class="externalLink" 
href="mailto:[email protected]";>Unsubscribe</a></td>
           <td><i>read only</i></td>
-          <td><a class="externalLink" 
href="https://mail-archives.apache.org/mod_mbox/www-announce/";>mail-archives.apache.org</a><br
 />
+          <td>
               <a class="externalLink" 
href="https://lists.apache.org/[email protected]";>lists.apache.org</a>
           </td>
-          <td><a class="externalLink" 
href="https://markmail.org/list/org.apache.announce/";>markmail.org</a><br />
-              <a class="externalLink" 
href="https://old.nabble.com/Apache-News-and-Announce-f109.html";>old.nabble.com</a><br
 />
-              <a class="externalLink" 
href="https://www.mail-archive.com/[email protected]/";>www.mail-archive.com</a><br
 />
-              <a class="externalLink" 
href="https://news.gmane.org/gmane.comp.apache.announce";>news.gmane.org</a>
+          <td>
+              <a class="externalLink" 
href="https://www.mail-archive.com/[email protected]/";>www.mail-archive.com</a>
           </td>
         </tr>
       </table>


Reply via email to