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-dbcp.git
The following commit(s) were added to refs/heads/master by this push: new 908f4c75 Prepare for release candidate 908f4c75 is described below commit 908f4c754a3202e5da17aa1e275c683ebc9bb2f4 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Thu Feb 29 17:00:34 2024 -0500 Prepare for release candidate --- CONTRIBUTING.md | 5 +- NOTICE.txt | 10 +- README.md | 5 +- RELEASE-NOTES.txt | 191 +++++++++++++------- src/changes/changes.xml | 2 +- src/site/xdoc/download_dbcp.xml | 372 +++++++++++++++++++-------------------- src/site/xdoc/issue-tracking.xml | 204 ++++++++++----------- 7 files changed, 427 insertions(+), 362 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 39cd5c98..cf9b8149 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -49,13 +49,13 @@ 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 DBCP'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 -------------- @@ -109,7 +109,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/DBCP diff --git a/NOTICE.txt b/NOTICE.txt index 75a281ea..d4901a2c 100644 --- a/NOTICE.txt +++ b/NOTICE.txt @@ -1,5 +1,5 @@ -Apache Commons DBCP -Copyright 2001-2024 The Apache Software Foundation - -This product includes software developed at -The Apache Software Foundation (https://www.apache.org/). +Apache Commons DBCP +Copyright 2001-2024 The Apache Software Foundation + +This product includes software developed at +The Apache Software Foundation (https://www.apache.org/). diff --git a/README.md b/README.md index f28a6afe..954b884a 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,7 @@ Apache Commons DBCP [](https://github.com/apache/commons-dbcp/actions/workflows/maven.yml) [](https://app.codecov.io/gh/apache/commons-dbcp) [](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-dbcp2/?gav=true) -[](https://javadoc.io/doc/org.apache.commons/commons-dbcp2/2.11.0) +[](https://javadoc.io/doc/org.apache.commons/commons-dbcp2/2.12.0) [](https://github.com/apache/commons-dbcp/actions/workflows/codeql-analysis.yml) [](https://api.securityscorecards.dev/projects/github.com/apache/commons-dbcp) @@ -69,7 +69,7 @@ Alternatively, you can pull it from the central Maven repositories: <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-dbcp2</artifactId> - <version>2.11.0</version> + <version>2.12.0</version> </dependency> ``` @@ -111,7 +111,6 @@ Additional Resources + [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/DBCP) + [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 ------------------------- diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index a11411e3..9bee95bd 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,6 +1,47 @@ - Apache Commons DBCP - Version 2.11.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.12.0 +RELEASE NOTES + +The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.12.0. + +Apache Commons DBCP software implements Database Connection Pooling. + +This is a minor release, including bug fixes and enhancements. + +New features +------------ +* Add property project.build.outputTimestamp for build reproducibility. Thanks to Gary Gregory. +* Add null guards in DelegatingDatabaseMetaData constructor #352. Thanks to Heewon Lee. +* DBCP-473: Data source bean creation failed due to mismatched return type of setter and getter for connectionInitSqls in BasicDataSource: Add BasicDataSource.setConnectionInitSqls(List). Thanks to Steve Cohen, Gary Gregory. + +Fixed Bugs +---------- +* DBCP-590: BasicDataSource#setAbandonedUsageTracking has no effect. Thanks to Réda Housni Alaoui. +* DBCP-596: PoolingConnection.toString() causes StackOverflowError. Thanks to Aapo Haapanen, Gary Gregory. +* PooledConnectionImpl.destroyObject(PStmtKey, PooledObject) can throw NullPointerException #312. Thanks to Gary Gregory, Rémy Maucherat. +* PoolingConnection.destroyObject(PStmtKey, PooledObject) can throw NullPointerException #312. Thanks to Gary Gregory, Rémy Maucherat. +* DBCP-477: Fix examples in src/main/java/org/apache/commons/dbcp2/package-info.java. Thanks to Mubasher Usman, Gary Gregory. + +Changes +------- +* Use ReentrantLock in PoolableConnection.close, #591 Thanks to cortlepp-intershop. +* Bump commons-lang3 from 3.13.0 to 3.14.0. Thanks to Gary Gregory. +* Bump commons-parent from 64 to 66. Thanks to Gary Gregory. +* Bump org.slf4j:slf4j-simple from 2.0.9 to 2.0.12 #349. Thanks to Dependabot. + + +For complete information on Apache Commons DBCP, including instructions on how to submit bug reports, +patches, or suggestions for improvement, see the Apache Commons DBCP website: + +https://commons.apache.org/proper/commons-dbcp/ + +Download page: https://commons.apache.org/proper/commons-dbcp/download_dbcp.cgi + +----------------------------------------------------------------------------- + +Apache Commons DBCP +Version 2.11.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.11.0. @@ -10,7 +51,8 @@ This is a minor release, including bug fixes and enhancements. Changes in this version include: -Changes: +Changes +------- o Update call sites of deprecated APIs from Apache Commons Pool. Thanks to Gary Gregory. o Add DataSourceMXBean.getUserName() and deprecate getUsername(). Thanks to Gary Gregory, Dependabot. o Bump h2 from 2.2.220 to 2.2.224, #308. Thanks to Gary Gregory, Dependabot. @@ -29,9 +71,9 @@ Download page: https://commons.apache.org/dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.10.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.10.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.10.0. @@ -41,7 +83,8 @@ This is a minor release, including bug fixes and enhancements. Changes in this version include: -New features: +New features +------------ o Add and use AbandonedTrace#setLastUsed(Instant). Thanks to Gary Gregory. o - Add and use Duration versions of now deprecated APIs that use ints and longs. - Internally track durations with Duration objects instead of ints and longs. @@ -51,7 +94,8 @@ o Add Utils.getDisconnectionSqlCodes() and Utils.DISCONNECTION_SQL_CO o Make BasicDataSource.getConnectionPool() public. Thanks to Gary Gregory. o Add github/codeql-action. Thanks to Gary Gregory. -Fixed Bugs: +Fixed Bugs +---------- o Fix StackOverflowError in PoolableConnection.isDisconnectionSqlException #123. Thanks to newnewcoder, Gary Gregory. o PerUserPoolDataSourceFactory.getNewInstance(Reference) parsed defaultMaxWaitMillis as an int instead of a long. Thanks to Gary Gregory. o Reimplement time tracking in AbandonedTrace with an Instant instead of a long. Thanks to Gary Gregory. @@ -75,7 +119,8 @@ o PoolingDataSource.close() now always throws SQLException. Thanks to o [StepSecurity] ci: Harden GitHub Actions #282. Thanks to step-security-bot, Gary Gregory. o Fixes typos, missing or misplaced characters, and grammar issues #299. Thanks to Martin Wiesner. -Changes: +Changes +------- o Bump actions/cache from 2.1.6 to 3.0.8 #147, #176. Thanks to Dependabot, Gary Gregory. o Bump actions/checkout from 2.3.4 to 3.0.2 #139, #143, #173. Thanks to Dependabot, Gary Gregory. o Bump actions/setup-java from 2 to 3.6.0 #229. Thanks to Gary Gregory, Dependabot. @@ -112,9 +157,9 @@ Download page: https://commons.apache.org/dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.9.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.9.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.9.0. @@ -124,7 +169,8 @@ This is a minor release, including bug fixes and enhancements. Changes in this version include: -New features: +New features +------------ o Add and reuse Constants.KEY_USER and Constants.KEY_PASSWORD. Thanks to Gary Gregory. o Add and reuse DataSourceMXBean. Thanks to Frank Gasdorf, Gary Gregory. o Add and reuse DriverAdapterCPDS.{get|set}DurationBetweenEvictionRuns(), deprecate {get|set}TimeBetweenEvictionRunsMillis(long). Thanks to Gary Gregory. @@ -134,7 +180,8 @@ o Add and reuse KeyedCPDSConnectionFactory.setMaxConnLifetime(Duratio o Add and reuse KeyedCPDSConnectionFactory.setMaxConnLifetime(Duration), deprecate setMaxConnLifetimeMillis(long). Thanks to Gary Gregory. o Add and reuse InstanceKeyDataSource.{get|set}DefaultMaxWait(Duration), deprecate {get|set}DefaultMaxWaitMillis(long). Thanks to Gary Gregory. -Fixed Bugs: +Fixed Bugs +---------- o DBCP-569: Fix test random failure on TestSynchronizationOrder.testInterposedSynchronization, #84. Thanks to Florent Guillaume. o DBCP-568: ManagedConnection must clear its cached state after transaction completes, #75. Thanks to Florent Guillaume. o Minor Improvements #78. Thanks to Arturo Bernal. @@ -161,7 +208,8 @@ o DBCP-579: Performance of DelegatingConnection.prepareStatement(String) regres DelegatingConnection should also cache connection catalog string to avoid calling the Connection#getCatalog() for each key creation. Thanks to Shaktisinh Jhala, Gary Gregory. o BasicDataSource should test for the presence of a security manager dynamically, not once on initialization. Thanks to Gary Gregory. -Changes: +Changes +------- o Bump mockito-core from 3.5.11 to 3.11.2 #66, #72, #77, #85, #91, #105, #110, #116. Thanks to Dependabot. o Bump actions/checkout from v2.3.2 to v2.3.4 #65, #74. Thanks to Dependabot. o Bump actions/cache from v2 to v2.1.6 #90, #108. Thanks to Dependabot. @@ -193,9 +241,9 @@ Download page: https://commons.apache.org/dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.8.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.8.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.8.0. @@ -205,17 +253,20 @@ This is a minor release, including bug fixes and enhancements. Changes in this version include: -New features: +New features +------------ o DBCP-564: Fix BasicManagedDataSource leak of connections opened after transaction is rollback-only #39. Thanks to Florent Guillaume. o DBCP-566: Add clearStatementPoolOnReturn #42. Thanks to Robert Paschek, Gary Gregory, Phil Steitz. o DBCP-559: Add start, restart methods to BasicDataSource. #50. Thanks to Phil Steitz. -Fixed Bugs: +Fixed Bugs +---------- o DBCP-555: NPE when creating a SQLExceptionList with a null list. Thanks to Gary Gregory. o DBCP-558: Fix DelegatingConnection readOnly and autoCommit caching mechanism #35. Thanks to louislatreille. o Fix regression introduced by unreleased code clean-up #63. Thanks to Sebastian Haas. -Changes: +Changes +------- o Update to PR#36 - PrepareStatement and prepareCall methods are extracted #37. Thanks to DoiMasayuki, Alexander Norz, Gary Gregory. o Mask out user name and password from DriverAdapterCPDS.toString(). Thanks to Gary Gregory. o DBCP-650: Update Apache Commons Pool from 2.7.0 to 2.8.1, #48. Thanks to Gary Gregory, Dependabot. @@ -244,10 +295,10 @@ Download page: https://commons.apache.org/dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.7.0 - RELEASE NOTES - 7 July 2019 +Apache Commons DBCP +Version 2.7.0 +RELEASE NOTES +7 July 2019 The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.7.0. @@ -257,18 +308,21 @@ This is a minor release, including bug fixes and enhancements. Changes in this version include: -New features: +New features +------------ o DBCP-539: ManagedDataSource#close() should declare used exceptions. Thanks to Jacques Le Roux. o DBCP-547: Add a ConnectionFactory class name setting for BasicDataSource.createConnectionFactory() #33. Thanks to leechoongyon, Gary Gregory. o Add missing Javadocs. Thanks to Gary Gregory. -Fixed Bugs: +Fixed Bugs +---------- o DBCP-538: Wrong JMX base name derived in BasicDataSource#updateJmxName. Thanks to Ragnar Haugan, Gary Gregory. o DBCP-546: Avoid NPE when calling DriverAdapterCPDS.toString(). Thanks to Sergey Chupov. o DBCP-550: java.util.IllegalFormatException while building a message for a SQLFeatureNotSupportedException in Jdbc41Bridge.getObject(ResultSet,String,Class). Thanks to Gary Gregory. o Fix Javadoc link in README.md #21. Thanks to LichKing-lee. -Changes: +Changes +------- o DBCP-540: Close ObjectOutputStream before calling toByteArray() on underlying ByteArrayOutputStream #28. Thanks to emopers. o DBCP-541: Upgrade to JUnit Jupiter #19. Thanks to Allon Murienik. o DBCP-542: Fix tests on Java 11. Thanks to Zheng Feng, Gary Gregory. @@ -298,9 +352,9 @@ Download page: https://commons.apache.org/dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.6.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.6.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.6.0. @@ -310,17 +364,20 @@ This is a minor release, including bug fixes and enhancements. Changes in this version include: -New features: +New features +------------ o DBCP-534: Allow for manual connection eviction. Thanks to Peter Wicks. o DBCP-514: Allow DBCP to register with a TransactionSynchronizationRegistry for XA cases. Thanks to Tom Jenkinson, Gary Gregory. o DBCP-519: Add some toString() methods for debugging (never printing passwords.) Thanks to Gary Gregory. o DBCP-527: Add getters to some classes. Thanks to Gary Gregory. o DBCP-528: org.apache.commons.dbcp2.DriverManagerConnectionFactory should use a char[] instead of a String to store passwords. Thanks to Gary Gregory. -Fixed Bugs: +Fixed Bugs +---------- o DBCP-518: Allow DBCP to work with old Java 6/JDBC drivers without throwing AbstractMethodError. Thanks to Gary Gregory. -Changes: +Changes +------- o DBCP-517: Make defensive copies of char[] passwords. Thanks to Gary Gregory. o DBCP-515: Do not try to register synchronization when the transaction is no longer active. Thanks to Tom Jenkinson, Gary Gregory. o DBCP-516: Do not double returnObject back to the pool if there is a transaction context with a shared connection. Thanks to Tom Jenkinson, Gary Gregory. @@ -337,9 +394,9 @@ Download page: https://commons.apache.org/dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.5.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.5.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.5.0. @@ -349,15 +406,18 @@ This is a minor release, including bug fixes and enhancements and requires Java Changes in this version include: -New features: +New features +------------ o DBCP-506: Support JDBC 4.2. Thanks to Gary Gregory. o DBCP-479: Support default schema in configuration. Thanks to Guillaume Husta, Gary Gregory. -Fixed Bugs: +Fixed Bugs +---------- o DBCP-508: Prepared statement keys should take a Connection's schema into account. Thanks to Gary Gregory. o DBCP-512: Avoid exceptions when closing a connection in mutli-threaded use case. Thanks to Gary Gregory. -Changes: +Changes +------- o DBCP-505: Update Java requirement from version 7 to 8. Thanks to Gary Gregory. o DBCP-427: Examines 'SQLException's thrown by underlying connections or statements for fatal (disconnection) errors. Thanks to Vladimir Konkov, Phil Steitz, Gary Gregory. o DBCP-507: Change default for fail-fast connections from false to true. Thanks to Vladimir Konkov, Phil Steitz, Gary Gregory. @@ -378,9 +438,9 @@ Download from https://commons.apache.org/proper/commons-dbcp/download_dbcp.cgi Download page: https://commons.apache.org/dbcp/download_dbcp.cgi - Apache Commons DBCP - Version 2.4.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.4.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.4.0. @@ -391,11 +451,13 @@ This is a minor release, including bug fixes and enhancements, which you can dow Changes in this version include: -Fixed Bugs: +Fixed Bugs +---------- o DBCP-484: Connection leak during XATransaction in high load. Thanks to Emanuel Freitas. o DBCP-496: Add support for pooling CallableStatements to the org.apache.commons.dbcp2.cpdsadapter package. Thanks to Gary Gregory. -Changes: +Changes +------- o DBCP-492: Drop Ant build. Thanks to Gary Gregory. o DBCP-491: Ensure DBCP ConnectionListener can deal with transaction managers which invoke rollback in a separate thread. Thanks to Zheng Feng, Gary Gregory. o DBCP-494: org.apache.commons.dbcp2.PStmtKey should make copies of given arrays in constructors. Thanks to Gary Gregory. @@ -418,9 +480,9 @@ Download from https://commons.apache.org/proper/commons-dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.3.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.3.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.3.0. @@ -430,11 +492,13 @@ This is a minor release, including bug fixes and enhancements. Changes in this version include: -Fixed Bugs: +Fixed Bugs +---------- o DBCP-476: AbandonedTrace.getTrace() contains race condition Thanks to Gary Evesson, Richard Cordova. o DBCP-482: Avoid javax.management.InstanceNotFoundException on shutdown when a bean is not registered. Thanks to Dennis Lloyd, Gary Gregory. -Changes: +Changes +------- o DBCP-483: Make constant public: org.apache.commons.dbcp2.PoolingDriver.URL_PREFIX. Thanks to Gary Gregory. o DBCP-486: DriverAdapterCPDS.setUser(), setPassword(), and getPooledConnection() with null arguments throw NullPointerExceptions when connection properties are set. Thanks to Gary Gregory. o DBCP-487: Add API org.apache.commons.dbcp2.datasources.PerUserPoolDataSource.clear(). Thanks to Gary Gregory. @@ -451,9 +515,9 @@ Download from https://commons.apache.org/proper/commons-dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.2.0 - RELEASE NOTES +Apache Commons DBCP +Version 2.2.0 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.2.0. @@ -463,7 +527,8 @@ This is a minor release, including bug fixes and enhancements. Changes in this version include: -New features: +New features +------------ o DBCP-451: Add constructor DriverManagerConnectionFactory(String). o DBCP-462: Refactoring to prepare for a future patch to enable pooling of all prepared and callable statements in PoolingConnection. Thanks to Keiichi Fujino. @@ -472,7 +537,8 @@ o DBCP-458: Make it simpler to extend BasicDataSource to allow sub-classes to o DBCP-474: Enable pooling of all prepared and callable statements inPoolingConnection. Thanks to Keiichi Fujino. -Fixed Bugs: +Fixed Bugs +---------- o DBCP-481: Update Apache Commons Pool from 2.4.2 to 2.5.0. Thanks to Gary Gregory. o DBCP-454: OSGi declarations contain multiple import headers for javax.transaction. Thanks to Philipp Marx, Matt Sicker. o DBCP-478: Wrong parameter name in site documentation for BasicDataSource Configuration Parameters. Thanks to nicola mele. @@ -505,7 +571,6 @@ o DBCP-457: When using a BasicDataSource, pass changes related to the handling configuration may be updated dynamically. - For complete information on Apache Commons DBCP, including instructions on how to submit bug reports, patches, or suggestions for improvement, see the Apache Commons DBCP website: @@ -515,9 +580,9 @@ Download from https://commons.apache.org/proper/commons-dbcp/download_dbcp.cgi ----------------------------------------------------------------------------- - Apache Commons DBCP - Version 2.1.1 - RELEASE NOTES +Apache Commons DBCP +Version 2.1.1 +RELEASE NOTES The Apache Commons DBCP team is pleased to announce the release of Apache Commons DBCP 2.1.1. @@ -527,14 +592,16 @@ This is a patch release, including bug fixes only. Changes in this version include: -Fixed Bugs: +Fixed Bugs +---------- o DBCP-441: Added BasicDataSource abandonedUsageTracking property missing from BasicDataSourceFactory. o DBCP-442: SharedPoolDataSource getConnection fails when testOnBorrow is set with a null validation query. o DBCP-438: Nested connections in a transaction (local) throws null pointer. Thanks to Raihan Kibria. o DBCP-437: BasicDataSource does not set disconnectionSql properties on its PoolableConnectionFactory. -Changes: +Changes +------- o Updated pool version to 2.4.2. The fix for POOL-300 may cause DBCP users to see more reports of abandoned connections (if removal and logging are configured). Prior to the fix for POOL-300, the PrintWriter used to log diff --git a/src/changes/changes.xml b/src/changes/changes.xml index 63ddbbf4..aa4f46b1 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -62,7 +62,7 @@ The <action> type attribute can be add,update,fix,remove. EvictionTimer --> <body> - <release version="2.11.1" date="2024-MM-DD" description="This is a minor release, including bug fixes and enhancements."> + <release version="2.12.0" date="2024-MM-DD" description="This is a minor release, including bug fixes and enhancements."> <!-- FIX --> <action type="fix" issue="DBCP-590" dev="psteitz" due-to=" Réda Housni Alaoui">BasicDataSource#setAbandonedUsageTracking has no effect.</action> <action type="fix" issue="DBCP-596" dev="ggregory" due-to="Aapo Haapanen, Gary Gregory">PoolingConnection.toString() causes StackOverflowError.</action> diff --git a/src/site/xdoc/download_dbcp.xml b/src/site/xdoc/download_dbcp.xml index ce0badd8..6488e7a6 100644 --- a/src/site/xdoc/download_dbcp.xml +++ b/src/site/xdoc/download_dbcp.xml @@ -1,186 +1,186 @@ -<?xml version="1.0"?> -<!-- -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 - - http://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. ---> -<!-- - +======================================================================+ - |**** ****| - |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****| - |**** DO NOT EDIT DIRECTLY ****| - |**** ****| - +======================================================================+ - | TEMPLATE FILE: download-page-template.xml | - | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | - +======================================================================+ - | | - | 1) Re-generate using: mvn commons-build:download-page | - | | - | 2) Set the following properties in the component's pom: | - | - commons.componentid (required, alphabetic, lower case) | - | - commons.release.version (required) | - | - commons.release.name (required) | - | - commons.binary.suffix (optional) | - | (defaults to "-bin", set to "" for pre-maven2 releases) | - | - commons.release.desc (optional) | - | - commons.release.subdir (optional) | - | - commons.release.hash (optional, lowercase, default sha512) | - | | - | - commons.release.[234].version (conditional) | - | - commons.release.[234].name (conditional) | - | - commons.release.[234].binary.suffix (optional) | - | - commons.release.[234].desc (optional) | - | - commons.release.[234].subdir (optional) | - | - commons.release.[234].hash (optional, lowercase, [sha512])| - | | - | 3) Example Properties | - | (commons.release.name inherited by parent: | - | ${project.artifactId}-${commons.release.version} | - | | - | <properties> | - | <commons.componentid>math</commons.componentid> | - | <commons.release.version>1.2</commons.release.version> | - | </properties> | - | | - +======================================================================+ ---> -<document> - <properties> - <title>Download Apache Commons DBCP</title> - <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> - </properties> - <body> - <section name="Download Apache Commons DBCP"> - <subsection name="Using a Mirror"> - <p> - We recommend you use a mirror to download our release - builds, but you <strong>must</strong> <a href="https://www.apache.org/info/verification.html">verify the integrity</a> of - the downloaded files using signatures downloaded from our main - distribution directories. Recent releases (48 hours) may not yet - be available from all the mirrors. - </p> - - <p> - You are currently using <b>[preferred]</b>. If you - encounter a problem with this mirror, please select another - mirror. If all mirrors are failing, there are <i>backup</i> - 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] - </p> - - <form action="[location]" method="get" id="SelectMirror"> - <p> - Other mirrors: - <select name="Preferred"> - [if-any http] - [for http]<option value="[http]">[http]</option>[end] - [end] - [if-any ftp] - [for ftp]<option value="[ftp]">[ftp]</option>[end] - [end] - [if-any backup] - [for backup]<option value="[backup]">[backup] (backup)</option>[end] - [end] - </select> - <input type="submit" value="Change"></input> - </p> - </form> - - <p> - It is essential that you - <a href="https://www.apache.org/info/verification.html">verify the integrity</a> - of downloaded files, preferably using the <code>PGP</code> signature (<code>*.asc</code> files); - failing that using the <code>SHA512</code> hash (<code>*.sha512</code> checksum files). - </p> - <p> - The <a href="https://downloads.apache.org/commons/KEYS">KEYS</a> - file contains the public PGP keys used by Apache Commons developers - to sign releases. - </p> - </subsection> - </section> - <section name="Apache Commons DBCP 2.11.0 for JDBC 4.2 on Java 8"> - <subsection name="Binaries"> - <table> - <tr> - <td><a href="[preferred]/commons/dbcp/binaries/commons-dbcp2-2.11.0-bin.tar.gz">commons-dbcp2-2.11.0-bin.tar.gz</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.11.0-bin.tar.gz.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.11.0-bin.tar.gz.asc">pgp</a></td> - </tr> - <tr> - <td><a href="[preferred]/commons/dbcp/binaries/commons-dbcp2-2.11.0-bin.zip">commons-dbcp2-2.11.0-bin.zip</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.11.0-bin.zip.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.11.0-bin.zip.asc">pgp</a></td> - </tr> - </table> - </subsection> - <subsection name="Source"> - <table> - <tr> - <td><a href="[preferred]/commons/dbcp/source/commons-dbcp2-2.11.0-src.tar.gz">commons-dbcp2-2.11.0-src.tar.gz</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.11.0-src.tar.gz.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.11.0-src.tar.gz.asc">pgp</a></td> - </tr> - <tr> - <td><a href="[preferred]/commons/dbcp/source/commons-dbcp2-2.11.0-src.zip">commons-dbcp2-2.11.0-src.zip</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.11.0-src.zip.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.11.0-src.zip.asc">pgp</a></td> - </tr> - </table> - </subsection> - </section> - <section name="Apache Commons DBCP 2.4.0 for JDBC 4.1 on Java 7"> - <subsection name="Binaries"> - <table> - <tr> - <td><a href="[preferred]/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.tar.gz">commons-dbcp2-2.4.0-bin.tar.gz</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.tar.gz.sha256">sha256</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.tar.gz.asc">pgp</a></td> - </tr> - <tr> - <td><a href="[preferred]/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.zip">commons-dbcp2-2.4.0-bin.zip</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.zip.sha256">sha256</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.zip.asc">pgp</a></td> - </tr> - </table> - </subsection> - <subsection name="Source"> - <table> - <tr> - <td><a href="[preferred]/commons/dbcp/source/commons-dbcp2-2.4.0-src.tar.gz">commons-dbcp2-2.4.0-src.tar.gz</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.4.0-src.tar.gz.sha256">sha256</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.4.0-src.tar.gz.asc">pgp</a></td> - </tr> - <tr> - <td><a href="[preferred]/commons/dbcp/source/commons-dbcp2-2.4.0-src.zip">commons-dbcp2-2.4.0-src.zip</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.4.0-src.zip.sha256">sha256</a></td> - <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.4.0-src.zip.asc">pgp</a></td> - </tr> - </table> - </subsection> - </section> - <section name="Archives"> - <p> - Older releases can be obtained from the archives. - </p> - <ul> - <li class="download"><a href="[preferred]/commons/dbcp/">browse download area</a></li> - <li><a href="https://archive.apache.org/dist/commons/dbcp/">archives...</a></li> - </ul> - </section> - </body> -</document> +<?xml version="1.0"?> +<!-- +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 + + http://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. +--> +<!-- + +======================================================================+ + |**** ****| + |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****| + |**** DO NOT EDIT DIRECTLY ****| + |**** ****| + +======================================================================+ + | TEMPLATE FILE: download-page-template.xml | + | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | + +======================================================================+ + | | + | 1) Re-generate using: mvn commons-build:download-page | + | | + | 2) Set the following properties in the component's pom: | + | - commons.componentid (required, alphabetic, lower case) | + | - commons.release.version (required) | + | - commons.release.name (required) | + | - commons.binary.suffix (optional) | + | (defaults to "-bin", set to "" for pre-maven2 releases) | + | - commons.release.desc (optional) | + | - commons.release.subdir (optional) | + | - commons.release.hash (optional, lowercase, default sha512) | + | | + | - commons.release.[234].version (conditional) | + | - commons.release.[234].name (conditional) | + | - commons.release.[234].binary.suffix (optional) | + | - commons.release.[234].desc (optional) | + | - commons.release.[234].subdir (optional) | + | - commons.release.[234].hash (optional, lowercase, [sha512])| + | | + | 3) Example Properties | + | (commons.release.name inherited by parent: | + | ${project.artifactId}-${commons.release.version} | + | | + | <properties> | + | <commons.componentid>math</commons.componentid> | + | <commons.release.version>1.2</commons.release.version> | + | </properties> | + | | + +======================================================================+ +--> +<document> + <properties> + <title>Download Apache Commons DBCP</title> + <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> + </properties> + <body> + <section name="Download Apache Commons DBCP"> + <subsection name="Using a Mirror"> + <p> + We recommend you use a mirror to download our release + builds, but you <strong>must</strong> <a href="https://www.apache.org/info/verification.html">verify the integrity</a> of + the downloaded files using signatures downloaded from our main + distribution directories. Recent releases (48 hours) may not yet + be available from all the mirrors. + </p> + + <p> + You are currently using <b>[preferred]</b>. If you + encounter a problem with this mirror, please select another + mirror. If all mirrors are failing, there are <i>backup</i> + 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] + </p> + + <form action="[location]" method="get" id="SelectMirror"> + <p> + Other mirrors: + <select name="Preferred"> + [if-any http] + [for http]<option value="[http]">[http]</option>[end] + [end] + [if-any ftp] + [for ftp]<option value="[ftp]">[ftp]</option>[end] + [end] + [if-any backup] + [for backup]<option value="[backup]">[backup] (backup)</option>[end] + [end] + </select> + <input type="submit" value="Change"></input> + </p> + </form> + + <p> + It is essential that you + <a href="https://www.apache.org/info/verification.html">verify the integrity</a> + of downloaded files, preferably using the <code>PGP</code> signature (<code>*.asc</code> files); + failing that using the <code>SHA512</code> hash (<code>*.sha512</code> checksum files). + </p> + <p> + The <a href="https://downloads.apache.org/commons/KEYS">KEYS</a> + file contains the public PGP keys used by Apache Commons developers + to sign releases. + </p> + </subsection> + </section> + <section name="Apache Commons DBCP 2.12.0 for JDBC 4.2 on Java 8"> + <subsection name="Binaries"> + <table> + <tr> + <td><a href="[preferred]/commons/dbcp/binaries/commons-dbcp2-2.12.0-bin.tar.gz">commons-dbcp2-2.12.0-bin.tar.gz</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.12.0-bin.tar.gz.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.12.0-bin.tar.gz.asc">pgp</a></td> + </tr> + <tr> + <td><a href="[preferred]/commons/dbcp/binaries/commons-dbcp2-2.12.0-bin.zip">commons-dbcp2-2.12.0-bin.zip</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.12.0-bin.zip.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.12.0-bin.zip.asc">pgp</a></td> + </tr> + </table> + </subsection> + <subsection name="Source"> + <table> + <tr> + <td><a href="[preferred]/commons/dbcp/source/commons-dbcp2-2.12.0-src.tar.gz">commons-dbcp2-2.12.0-src.tar.gz</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.12.0-src.tar.gz.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.12.0-src.tar.gz.asc">pgp</a></td> + </tr> + <tr> + <td><a href="[preferred]/commons/dbcp/source/commons-dbcp2-2.12.0-src.zip">commons-dbcp2-2.12.0-src.zip</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.12.0-src.zip.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.12.0-src.zip.asc">pgp</a></td> + </tr> + </table> + </subsection> + </section> + <section name="Apache Commons DBCP 2.4.0 for JDBC 4.1 on Java 7"> + <subsection name="Binaries"> + <table> + <tr> + <td><a href="[preferred]/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.tar.gz">commons-dbcp2-2.4.0-bin.tar.gz</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.tar.gz.sha256">sha256</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.tar.gz.asc">pgp</a></td> + </tr> + <tr> + <td><a href="[preferred]/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.zip">commons-dbcp2-2.4.0-bin.zip</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.zip.sha256">sha256</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/binaries/commons-dbcp2-2.4.0-bin.zip.asc">pgp</a></td> + </tr> + </table> + </subsection> + <subsection name="Source"> + <table> + <tr> + <td><a href="[preferred]/commons/dbcp/source/commons-dbcp2-2.4.0-src.tar.gz">commons-dbcp2-2.4.0-src.tar.gz</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.4.0-src.tar.gz.sha256">sha256</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.4.0-src.tar.gz.asc">pgp</a></td> + </tr> + <tr> + <td><a href="[preferred]/commons/dbcp/source/commons-dbcp2-2.4.0-src.zip">commons-dbcp2-2.4.0-src.zip</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.4.0-src.zip.sha256">sha256</a></td> + <td><a href="https://downloads.apache.org/commons/dbcp/source/commons-dbcp2-2.4.0-src.zip.asc">pgp</a></td> + </tr> + </table> + </subsection> + </section> + <section name="Archives"> + <p> + Older releases can be obtained from the archives. + </p> + <ul> + <li class="download"><a href="[preferred]/commons/dbcp/">browse download area</a></li> + <li><a href="https://archive.apache.org/dist/commons/dbcp/">archives...</a></li> + </ul> + </section> + </body> +</document> diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml index 64bb739f..eefb84c4 100644 --- a/src/site/xdoc/issue-tracking.xml +++ b/src/site/xdoc/issue-tracking.xml @@ -1,102 +1,102 @@ -<?xml version="1.0"?> -<!-- -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 - - http://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. ---> -<!-- - +======================================================================+ - |**** ****| - |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****| - |**** DO NOT EDIT DIRECTLY ****| - |**** ****| - +======================================================================+ - | TEMPLATE FILE: issue-tracking-template.xml | - | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | - +======================================================================+ - | | - | 1) Re-generate using: mvn commons-build:jira-page | - | | - | 2) Set the following properties in the component's pom: | - | - commons.jira.id (required, alphabetic, upper case) | - | - commons.jira.pid (required, numeric) | - | | - | 3) Example Properties | - | | - | <properties> | - | <commons.jira.id>MATH</commons.jira.id> | - | <commons.jira.pid>12310485</commons.jira.pid> | - | </properties> | - | | - +======================================================================+ ---> -<document> - <properties> - <title>Apache Commons DBCP Issue tracking</title> - <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> - </properties> - <body> - - <section name="Apache Commons DBCP Issue tracking"> - <p> - Apache Commons DBCP uses <a href="https://issues.apache.org/jira/">ASF JIRA</a> for tracking issues. - See the <a href="https://issues.apache.org/jira/browse/DBCP">Apache Commons DBCP JIRA project page</a>. - </p> - - <p> - To use JIRA you may need to <a href="https://issues.apache.org/jira/secure/Signup!default.jspa">create an account</a> - (if you have previously created/updated Commons issues using Bugzilla an account will have been automatically - created and you can use the <a href="https://issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a> - page to get a new password). - </p> - - <p> - If you would like to report a bug, or raise an enhancement request with - Apache Commons DBCP please do the following: - <ol> - <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310469&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4">Search existing open bugs</a>. - If you find your issue listed then please add a comment with your details.</li> - <li><a href="mail-lists.html">Search the mailing list archive(s)</a>. - You may find your issue or idea has already been discussed.</li> - <li>Decide if your issue is a bug or an enhancement.</li> - <li>Submit either a <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310469&issuetype=1&priority=4&assignee=-1">bug report</a> - or <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310469&issuetype=4&priority=4&assignee=-1">enhancement request</a>.</li> - </ol> - </p> - - <p> - Please also remember these points: - <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 DBCP are all unpaid volunteers</li> - </ul> - </p> - - <p> - For more information on creating patches see the - <a href="https://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>. - </p> - - <p> - You may also find these links useful: - <ul> - <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310469&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4">All Open Apache Commons DBCP bugs</a></li> - <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310469&sorter/field=issuekey&sorter/order=DESC&status=5&status=6">All Resolved Apache Commons DBCP bugs</a></li> - <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310469&sorter/field=issuekey&sorter/order=DESC">All Apache Commons DBCP bugs</a></li> - </ul> - </p> - </section> - </body> -</document> +<?xml version="1.0"?> +<!-- +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 + + http://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. +--> +<!-- + +======================================================================+ + |**** ****| + |**** THIS FILE IS GENERATED BY THE COMMONS BUILD PLUGIN ****| + |**** DO NOT EDIT DIRECTLY ****| + |**** ****| + +======================================================================+ + | TEMPLATE FILE: issue-tracking-template.xml | + | commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates | + +======================================================================+ + | | + | 1) Re-generate using: mvn commons-build:jira-page | + | | + | 2) Set the following properties in the component's pom: | + | - commons.jira.id (required, alphabetic, upper case) | + | - commons.jira.pid (required, numeric) | + | | + | 3) Example Properties | + | | + | <properties> | + | <commons.jira.id>MATH</commons.jira.id> | + | <commons.jira.pid>12310485</commons.jira.pid> | + | </properties> | + | | + +======================================================================+ +--> +<document> + <properties> + <title>Apache Commons DBCP Issue tracking</title> + <author email="d...@commons.apache.org">Apache Commons Documentation Team</author> + </properties> + <body> + + <section name="Apache Commons DBCP Issue tracking"> + <p> + Apache Commons DBCP uses <a href="https://issues.apache.org/jira/">ASF JIRA</a> for tracking issues. + See the <a href="https://issues.apache.org/jira/browse/DBCP">Apache Commons DBCP JIRA project page</a>. + </p> + + <p> + To use JIRA you may need to <a href="https://issues.apache.org/jira/secure/Signup!default.jspa">create an account</a> + (if you have previously created/updated Commons issues using Bugzilla an account will have been automatically + created and you can use the <a href="https://issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a> + page to get a new password). + </p> + + <p> + If you would like to report a bug, or raise an enhancement request with + Apache Commons DBCP please do the following: + <ol> + <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310469&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4">Search existing open bugs</a>. + If you find your issue listed then please add a comment with your details.</li> + <li><a href="mail-lists.html">Search the mailing list archive(s)</a>. + You may find your issue or idea has already been discussed.</li> + <li>Decide if your issue is a bug or an enhancement.</li> + <li>Submit either a <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310469&issuetype=1&priority=4&assignee=-1">bug report</a> + or <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310469&issuetype=4&priority=4&assignee=-1">enhancement request</a>.</li> + </ol> + </p> + + <p> + Please also remember these points: + <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 DBCP are all unpaid volunteers</li> + </ul> + </p> + + <p> + For more information on creating patches see the + <a href="https://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>. + </p> + + <p> + You may also find these links useful: + <ul> + <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310469&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4">All Open Apache Commons DBCP bugs</a></li> + <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310469&sorter/field=issuekey&sorter/order=DESC&status=5&status=6">All Resolved Apache Commons DBCP bugs</a></li> + <li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310469&sorter/field=issuekey&sorter/order=DESC">All Apache Commons DBCP bugs</a></li> + </ul> + </p> + </section> + </body> +</document>