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-configuration.git
The following commit(s) were added to refs/heads/master by this push:
new e0c03440 Prepare for the next release candidate
new df9d3a36 Merge branch 'master' of
https://gitbox.apache.org/repos/asf/commons-configuration
e0c03440 is described below
commit e0c034409ec50b4cda369d03b031ef6b22d7a0f3
Author: Gary Gregory <garydgreg...@gmail.com>
AuthorDate: Tue Mar 5 19:19:42 2024 -0500
Prepare for the next release candidate
---
CONTRIBUTING.md | 5 +-
NOTICE.txt | 10 +-
README.md | 81 +--
RELEASE-NOTES.txt | 881 ++++++++++++++++++-------------
src/changes/changes.xml | 2 +-
src/changes/release-notes.vm | 30 +-
src/site/xdoc/download_configuration.xml | 372 ++++++-------
src/site/xdoc/issue-tracking.xml | 204 +++----
src/site/xdoc/mail-lists.xml | 38 +-
9 files changed, 857 insertions(+), 766 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 465e00cb..493ecaf9 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 Configuration'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/CONFIGURATION
diff --git a/NOTICE.txt b/NOTICE.txt
index 0e7b835c..655d659c 100644
--- a/NOTICE.txt
+++ b/NOTICE.txt
@@ -1,5 +1,5 @@
-Apache Commons Configuration
-Copyright 2001-2024 The Apache Software Foundation
-
-This product includes software developed at
-The Apache Software Foundation (https://www.apache.org/).
+Apache Commons Configuration
+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 73048a25..a8db88ed 100644
--- a/README.md
+++ b/README.md
@@ -46,7 +46,7 @@ Apache Commons Configuration
[](https://github.com/apache/commons-configuration/actions/workflows/maven.yml)
[](https://app.codecov.io/gh/apache/commons-configuration)
[](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-configuration2/?gav=true)
-[](https://javadoc.io/doc/org.apache.commons/commons-configuration2/2.9.0)
+[](https://javadoc.io/doc/org.apache.commons/commons-configuration2/2.10.0)
[](https://github.com/apache/commons-configuration/actions/workflows/codeql-analysis.yml)
[](https://api.securityscorecards.dev/projects/github.com/apache/commons-configuration)
@@ -60,27 +60,35 @@ More information can be found on the [Apache Commons
Configuration homepage](htt
The [Javadoc](https://commons.apache.org/proper/commons-configuration/apidocs)
can be browsed.
Questions related to the usage of Apache Commons Configuration 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-configuration/download_configuration.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-configuration2</artifactId>
- <version>2.9.0</version>
+ <version>2.10.0</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```.
@@ -89,13 +97,13 @@ You can learn more about contributing via GitHub in our
[contribution guidelines
License
-------
-This code is under the [Apache License
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 Configuration? Then [donate back to the
ASF](https://www.apache.org/foundation/contributing.html) to support the
development.
+Donating
+--------
+You like Apache Commons Configuration? 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/CONFIGURATION)
+ [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 31761120..38b731e2 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,10 +1,78 @@
+Apache Commons Configuration
+Version 2.10.0
+Release Notes
+
+Introducing Apache Commons Configuration
+----------------------------------------
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a
variety
+of sources.
+
+Tools to assist in the reading of configuration/preferences files in
+various formats
+
+Minor release with new features and updated dependencies.
+
+Changes in this version include:
+
+New features
+------------
+
+* Add AbstractConfiguration.getKeysInternal(String,
String) #300. Thanks to KeijoB, Gary Gregory.
+* Add ImmutableConfiguration.getKeys(String, String) #300.
Thanks to KeijoB, Gary Gregory.
+* Add
PrefixedKeysIterator.PrefixedKeysIterator(Iterator<String%gt;, String, String)
#300. Thanks to KeijoB, Gary Gregory.
+* Add Maven property project.build.outputTimestamp for
build reproducibility. Thanks to Gary Gregory.
+* Guard PatternSubtreeConfigurationWrapper constructor
against null #365. Thanks to Heewon Lee.
+
+Fixed Bugs
+----------
+
+* [StepSecurity] ci: Harden GitHub Actions #307. Thanks to
step-security-bot, Gary Gregory.
+* CONFIGURATION-834: ConfirgurationPropertySource doesn't supply resolved
values #309. Thanks to Keith Barlow, Gary Gregory.
+* Take prefix delimiter into account when
SubsetConfiguration.getKeysInternal() is called #300. Thanks to KeijoB, Gary
Gregory.
+* Guard ConfigurationMap against null configuration #355.
Thanks to Heewon Lee, Gary Gregory.
+* CONFIGURATION-838: Properties parser stack overflows on large single-key
inputs #369. Thanks to Ian Lynagh.
+* DatabaseConfiguration.AbstractJdbcOperation.execute()
throws NullPointerException when no data source is set #368. Thanks to Heewon
Lee, Gary Gregory.
+
+Changes
+-------
+
+* Bump jackson-databind from 2.14.2 to 2.16.1 #297, #303,
#326, #331, #340. Thanks to Dependabot.
+* Bump commons-io:commons-io from 2.11.0 to 2.15.1. Thanks
to Gary Gregory.
+* Bump spring-* from 5.3.26 to 5.3.32. Thanks to Gary
Gregory.
+* Bump commons-parent from 57 to 66. Thanks to Gary
Gregory.
+* Bump commons-codec:commons-codec from 1.15 to 1.16.1.
Thanks to Gary Gregory.
+* Bump commons-lang3 from 3.11 to 3.14.0. Thanks to Gary
Gregory.
+* Bump org.yaml:snakeyaml from 2.0 to 2.2 #312, #315.
Thanks to Dependabot.
+* Bump slf4j.version from 2.0.7 to 2.0.12 #358. Thanks to
Dependabot.
+* Bump org.apache.commons:commons-dbcp2 from 2.9.0 to
2.12.0. Thanks to Gary Gregory.
+* Bump org.apache.commons:commons-pool2 from 2.11.1 to
2.12.0. Thanks to Gary Gregory.
+* Bump org.apache.logging.log4j:log4j-1.2-* from 2.20.0 to
2.23.0 #334, #339, #367. Thanks to Gary Gregory, Dependabot.
+* Bump org.apache.commons:commons-text from 1.10.0 to
1.11.0. Thanks to Gary Gregory.
+* Bump commons-logging:commons-logging from 1.2 to 1.3.0.
Thanks to Gary Gregory.
+
+
+Historical list of changes:
https://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Apache Commons
Configuration website:
+
+https://commons.apache.org/proper/commons-configuration/
+
+Download it from
https://commons.apache.org/proper/commons-configuration//download_configuration.cgi
+
+-----------------------------------------------------------------------------
+
Apache Commons Configuration
Version 2.9.0
Release Notes
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -19,39 +87,45 @@ Minor release with new features and updated dependencies.
Changes in this version include:
-New features:
-o CONFIGURATION-799: Add
DefaultConversionHandler#setListDelimiterHandler(ListDelimiterHandler). Thanks
to Xinshiyou, Gary Gregory.
-
-Fixed Bugs:
-o CONFIGURATION-799: CombinedConfiguration#getKeys() can throw
NoSuchElementException. Thanks to Jarek Sacha, Gary Gregory.
-o CONFIGURATION-822: Fix ambiguity on the section determining #229. Thanks to
Branislav Be?o, Gary Gregory, Bruno P. Kinoshita.
-o Use Java style array decelerations #244. Thanks to
Arturo Bernal.
-o Add ImmutableNode.stream(). Thanks to Gary Gregory.
-o Avoid NullPointerException in
org.apache.commons.configuration2.web.AppletConfiguration.getKeysInternal().
Thanks to Gary Gregory.
-o Fix JDBC prepared statements leak in
org.apache.commons.configuration2.DatabaseConfiguration.clearPropertyDirect(String).
Thanks to Gary Gregory.
-
-Changes:
-o CONFIGURATION-815: Bump optional Apache Log4j 1.2.17 with 2.20.0. Thanks to
Gary Gregory.
-o Bump actions/checkout from 3 to 3.1.0 #224. Thanks to
Gary Gregory, Dependabot.
-o Bump actions/setup-java from 3 to 3.5.1. Thanks to Gary
Gregory.
-o Bump spotbugs-maven-plugin from 4.7.0.0 to 4.7.3.0 #193,
#195, #228, #237. Thanks to Dependabot, Gary Gregory.
-o Bump spotbugs from 4.7.0 to 4.7.3. Thanks to Gary
Gregory.
-o Bump org.springframework:spring-* from 5.3.21 to 5.3.26.
Thanks to Dependabot, Gary Gregory.
-o Bump junit-jupiter from 5.8.2 to 5.9.1 #197, #217.
Thanks to Dependabot.
-o Bump mockito-core from 4.6.1 to 4.11.0 #200, #235, #249,
#257, #259. Thanks to Dependabot, Gary Gregory.
-o Bump slf4j.version from 1.7.36 to 2.0.7 #202, #210,
#215, #238, #241, #291. Thanks to Dependabot.
-o Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #201.
Thanks to Dependabot.
-o Bump maven-javadoc-plugin from 3.4.0 to 3.4.1. Thanks to
Gary Gregory.
-o Bump maven-pmd-plugin 3.17.0 to 3.19.0. Thanks to Gary
Gregory.
-o Bump pmd from 6.47.0 to 6.53.0. Thanks to Gary Gregory.
-o Bump snakeyaml from 1.30 to 2.0 #203, #212, #219, #282,
#283. Thanks to Dependabot, strangelookingnerd.
-o Bump jackson-databind from 2.13.3 to 2.14.2 #227, #246,
#274. Thanks to Gary Gregory.
-o Bump spring.version from 5.3.22 to 5.3.23 #211. Thanks
to Dependabot.
-o Bump commons-parent from 53 to 56 #216, #253. Thanks to
Dependabot, Gary Gregory.
-o Bump log4j.version from 2.18.0 to 2.20.0 #213, #281.
Thanks to Dependabot.
-o Bump japicmp-maven-plugin from 0.15.7 to 0.17.1. Thanks
to Gary Gregory.
-o Bump commons-text from 1.9 to 1.10.0 #221. Thanks to
Dependabot.
-o Bump actions/cache from 3.0.8 to 3.0.10 #223, #225.
Thanks to Dependabot.
+New features
+------------
+
+* CONFIGURATION-799: Add
DefaultConversionHandler#setListDelimiterHandler(ListDelimiterHandler). Thanks
to Xinshiyou, Gary Gregory.
+
+Fixed Bugs
+----------
+
+* CONFIGURATION-799: CombinedConfiguration#getKeys() can throw
NoSuchElementException. Thanks to Jarek Sacha, Gary Gregory.
+* CONFIGURATION-822: Fix ambiguity on the section determining #229. Thanks to
Branislav Be?o, Gary Gregory, Bruno P. Kinoshita.
+* Use Java style array decelerations #244. Thanks to
Arturo Bernal.
+* Add ImmutableNode.stream(). Thanks to Gary Gregory.
+* Avoid NullPointerException in
org.apache.commons.configuration2.web.AppletConfiguration.getKeysInternal().
Thanks to Gary Gregory.
+* Fix JDBC prepared statements leak in
org.apache.commons.configuration2.DatabaseConfiguration.clearPropertyDirect(String).
Thanks to Gary Gregory.
+
+Changes
+-------
+
+* CONFIGURATION-815: Bump optional Apache Log4j 1.2.17 with 2.20.0. Thanks to
Gary Gregory.
+* Bump actions/checkout from 3 to 3.1.0 #224. Thanks to
Gary Gregory, Dependabot.
+* Bump actions/setup-java from 3 to 3.5.1. Thanks to Gary
Gregory.
+* Bump spotbugs-maven-plugin from 4.7.0.0 to 4.7.3.0 #193,
#195, #228, #237. Thanks to Dependabot, Gary Gregory.
+* Bump spotbugs from 4.7.0 to 4.7.3. Thanks to Gary
Gregory.
+* Bump org.springframework:spring-* from 5.3.21 to 5.3.26.
Thanks to Dependabot, Gary Gregory.
+* Bump junit-jupiter from 5.8.2 to 5.9.1 #197, #217.
Thanks to Dependabot.
+* Bump mockito-core from 4.6.1 to 4.11.0 #200, #235, #249,
#257, #259. Thanks to Dependabot, Gary Gregory.
+* Bump slf4j.version from 1.7.36 to 2.0.7 #202, #210,
#215, #238, #241, #291. Thanks to Dependabot.
+* Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #201.
Thanks to Dependabot.
+* Bump maven-javadoc-plugin from 3.4.0 to 3.4.1. Thanks to
Gary Gregory.
+* Bump maven-pmd-plugin 3.17.0 to 3.19.0. Thanks to Gary
Gregory.
+* Bump pmd from 6.47.0 to 6.53.0. Thanks to Gary Gregory.
+* Bump snakeyaml from 1.30 to 2.0 #203, #212, #219, #282,
#283. Thanks to Dependabot, strangelookingnerd.
+* Bump jackson-databind from 2.13.3 to 2.14.2 #227, #246,
#274. Thanks to Gary Gregory.
+* Bump spring.version from 5.3.22 to 5.3.23 #211. Thanks
to Dependabot.
+* Bump commons-parent from 53 to 56 #216, #253. Thanks to
Dependabot, Gary Gregory.
+* Bump log4j.version from 2.18.0 to 2.20.0 #213, #281.
Thanks to Dependabot.
+* Bump japicmp-maven-plugin from 0.15.7 to 0.17.1. Thanks
to Gary Gregory.
+* Bump commons-text from 1.9 to 1.10.0 #221. Thanks to
Dependabot.
+* Bump actions/cache from 3.0.8 to 3.0.10 #223, #225.
Thanks to Dependabot.
Historical list of changes:
https://commons.apache.org/proper/commons-configuration/changes-report.html
@@ -63,15 +137,15 @@ https://commons.apache.org/proper/commons-configuration/
Download it from
https://commons.apache.org/proper/commons-configuration//download_configuration.cgi
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.8.0
Release Notes
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -86,83 +160,89 @@ Minor release with new features and updated dependencies.
Changes in this version include:
-New features:
-o Implement Iterable in ImmutableNode #74. Thanks to
SethiPandi.
-o Add PropertiesConfigurationLayout.getBlankLinesBefore()
and deprecate getBlancLinesBefore(). Thanks to Gary Gregory.
-o Add PropertiesConfigurationLayout.setBlankLinesBefore()
and deprecate setBlancLinesBefore(). Thanks to Gary Gregory.
-o Add
PropertiesConfigurationLayout.PropertyLayoutData.getBlankLines() and deprecate
getBlancLines(). Thanks to Gary Gregory.
-o Add
PropertiesConfigurationLayout.PropertyLayoutData.setBlankLines() and deprecate
setBlancLines(). Thanks to Gary Gregory.
-o CONFIGURATION-789: Add ImmutableConfiguration.getEnum() methods. Thanks to
Gary Gregory.
-o CONFIGURATION-789: Add ImmutableConfiguration.getDuration() methods. Thanks
to Gary Gregory.
-
-Fixed Bugs:
-o CONFIGURATION-753: Make interpolation of collections and arrays in
ConfigurationInterpolator consistent with
+New features
+------------
+
+* Implement Iterable in ImmutableNode #74. Thanks to
SethiPandi.
+* Add PropertiesConfigurationLayout.getBlankLinesBefore()
and deprecate getBlancLinesBefore(). Thanks to Gary Gregory.
+* Add PropertiesConfigurationLayout.setBlankLinesBefore()
and deprecate setBlancLinesBefore(). Thanks to Gary Gregory.
+* Add
PropertiesConfigurationLayout.PropertyLayoutData.getBlankLines() and deprecate
getBlancLines(). Thanks to Gary Gregory.
+* Add
PropertiesConfigurationLayout.PropertyLayoutData.setBlankLines() and deprecate
setBlancLines(). Thanks to Gary Gregory.
+* CONFIGURATION-789: Add ImmutableConfiguration.getEnum() methods. Thanks to
Gary Gregory.
+* CONFIGURATION-789: Add ImmutableConfiguration.getDuration() methods. Thanks
to Gary Gregory.
+
+Fixed Bugs
+----------
+
+* CONFIGURATION-753: Make interpolation of collections and arrays in
ConfigurationInterpolator consistent with
behavior of DefaultConversionHandler. Add
ConfigurationInterpolator.setStringConverter to
allow customized string conversion behavior.
-o CONFIGURATION-795: Computation of blank lines after header comment #82.
Thanks to dpeger.
-o CONFIGURATION-801: Remove redundant initializer #110. Thanks to Arturo
Bernal.
-o CONFIGURATION-802: Use final #111. Thanks to Arturo Bernal.
-o CONFIGURATION-803: Java 8 lambda improvements and more #112. Thanks to
Arturo Bernal.
-o CONFIGURATION-804: Redundant local variable #113. Thanks to Arturo Bernal.
-o CONFIGURATION-805: Use try with resource #114. Thanks to Arturo Bernal.
-o CONFIGURATION-805: [Javadoc] Specify that typed getList returns null for
missing key #100. Thanks to Roman Zaynetdinov.
-o Mention EnvironmentConfiguration in the list of
configuration sources #45. Thanks to Oliver B. Fischer.
-o CONFIGURATION-808: DefaultListDelimiterHandler.escapeList working only for
List>String< #137. Thanks to cigaly.
-o Use final #141. Thanks to Arturo Bernal.
-o Replace test asserts by simpler but equivalent calls.
#139 Thanks to Arturo Bernal.
-o CONFIGURATION-764: Single Variable Interpolation #182. Thanks to Ning
Zhang, Matt Juntunen, Bruno P. Kinoshita, Gary Gregory.
-o Implement proper concurrency in ConstantLookup. Thanks
to Gary Gregory.
-o CONFIGURATION-813: Support new namespace jakarta.mail.* used by javamail
2.0+ (first release October 2020) #186. Thanks to Dependabot.
-
-Changes:
-o Unclosed file handle when reading config from JAR file
URL.
+* CONFIGURATION-795: Computation of blank lines after header comment #82.
Thanks to dpeger.
+* CONFIGURATION-801: Remove redundant initializer #110. Thanks to Arturo
Bernal.
+* CONFIGURATION-802: Use final #111. Thanks to Arturo Bernal.
+* CONFIGURATION-803: Java 8 lambda improvements and more #112. Thanks to
Arturo Bernal.
+* CONFIGURATION-804: Redundant local variable #113. Thanks to Arturo Bernal.
+* CONFIGURATION-805: Use try with resource #114. Thanks to Arturo Bernal.
+* CONFIGURATION-805: [Javadoc] Specify that typed getList returns null for
missing key #100. Thanks to Roman Zaynetdinov.
+* Mention EnvironmentConfiguration in the list of
configuration sources #45. Thanks to Oliver B. Fischer.
+* CONFIGURATION-808: DefaultListDelimiterHandler.escapeList working only for
List>String< #137. Thanks to cigaly.
+* Use final #141. Thanks to Arturo Bernal.
+* Replace test asserts by simpler but equivalent calls.
#139 Thanks to Arturo Bernal.
+* CONFIGURATION-764: Single Variable Interpolation #182. Thanks to Ning
Zhang, Matt Juntunen, Bruno P. Kinoshita, Gary Gregory.
+* Implement proper concurrency in ConstantLookup. Thanks
to Gary Gregory.
+* CONFIGURATION-813: Support new namespace jakarta.mail.* used by javamail
2.0+ (first release October 2020) #186. Thanks to Dependabot.
+
+Changes
+-------
+
+* Unclosed file handle when reading config from JAR file
URL.
Add and use FileBasedBuilderProperties.setURL(URL,
URLConnectionOptions). Thanks to Robin Jansohn, Gary Gregory, Rob Spoor.
-o Make default interpolation prefix lookups configurable
via system property. Remove dns, url, and script
+* Make default interpolation prefix lookups configurable
via system property. Remove dns, url, and script
lookups from defaults. If these lookups are required for
use in AbstractConfiguration subclasses, they must
be enabled via system property. See
ConfigurationInterpolator.getDefaultPrefixLookups() for details.
-o Bump actions/cache from 2 to 3.0.4 #99, #151, #169.
Thanks to Dependabot, Gary Gregory.
-o Bump actions/checkout from 1 to 3 #47, #62, #70, #85,
#150, #163. Thanks to Dependabot.
-o Bump actions/setup-java from 1.4.0 to 3 #63, #65, #73,
#174. Thanks to Dependabot, Gary Gregory.
-o Bump codeql-action from v1 to v2. Thanks to Dependabot,
Matt Juntunen.
-o Bump Spring dependency versions:
+* Bump actions/cache from 2 to 3.0.4 #99, #151, #169.
Thanks to Dependabot, Gary Gregory.
+* Bump actions/checkout from 1 to 3 #47, #62, #70, #85,
#150, #163. Thanks to Dependabot.
+* Bump actions/setup-java from 1.4.0 to 3 #63, #65, #73,
#174. Thanks to Dependabot, Gary Gregory.
+* Bump codeql-action from v1 to v2. Thanks to Dependabot,
Matt Juntunen.
+* Bump Spring dependency versions:
org.springframework:spring-beans 4.3.26.RELEASE -> 5.3.21
org.springframework:spring-context 4.3.26.RELEASE ->
5.3.21
org.springframework:spring-core 4.3.26.RELEASE -> 5.3.21
org.springframework:spring-test 4.3.26.RELEASE -> 5.3.21
#165, #172 Thanks to Dependabot, Matt Juntunen, kinow,
Gary Gregory.
-o Bump commons-parent from 52 to 53. Thanks to Dependabot,
Matt Juntunen.
-o CONFIGURATION-787: Bump Apache Commons Lang from 3.9 to 3.12.0. Thanks to
Gary Gregory.
-o CONFIGURATION-790: Bump com.fasterxml.jackson.core:jackson-databind from
2.10.3 to 2.13.3, #60. Thanks to Gary Gregory, Dependabot.
-o Bump Slf4j test dependencies:
+* Bump commons-parent from 52 to 53. Thanks to Dependabot,
Matt Juntunen.
+* CONFIGURATION-787: Bump Apache Commons Lang from 3.9 to 3.12.0. Thanks to
Gary Gregory.
+* CONFIGURATION-790: Bump com.fasterxml.jackson.core:jackson-databind from
2.10.3 to 2.13.3, #60. Thanks to Gary Gregory, Dependabot.
+* Bump Slf4j test dependencies:
org.slf4j:slf4j-api 1.7.26 -> 1.7.33,
org.slf4j:slf4j-ext 1.7.26 -> 1.7.33,
org.slf4j:slf4j-log4j12 1.7.26 -> 1.7.33,
org.slf4j:slf4j-nop 1.7.26 -> 1.7.33. Thanks to Gary
Gregory.
-o Bump commons-parent from 50 to 52. Thanks to Dependabot.
-o Bump mailapi from 1.6.4 to 1.6.7 #48. Thanks to
Dependabot, Gary Gregory.
-o Bump spotbugs-maven-plugin from 3.1.12.2 to 4.7.0.0,
#55, #75, #79, #93, #116, #183. Thanks to Dependabot, Gary Gregory.
-o Bump hsqldb from 2.5.0 to 2.5.2 #54, #128. Thanks to
Dependabot.
-o Bump commons-text from 1.8 to 1.9. Thanks to Gary
Gregory.
-o Bump servlet-api from 2.4 to 2.5 #58. Thanks to Gary
Gregory.
-o Bump maven-checkstyle-plugin from 3.1.0 to 3.1.2, #57,
#97. Thanks to Gary Gregory.
-o Bump commons-pool2 from 2.8.0 to 2.10.0, #61, #124.
Thanks to Dependabot, Gary Gregory.
-o Bump optional commons-codec from 1.14 to 1.15. Thanks to
Gary Gregory.
-o Bump checkstyle from 8.26 to 9.3, #66, #71, #90, #101,
#118, #121, #132, #155. Thanks to Dependabot, Gary Gregory.
-o Bump commons.jacoco.version 0.8.5 to 0.8.8 (Fixes Java
15 builds). Thanks to Gary Gregory.
-o Bump tests from commons-pool2 2.10.0 to 2.11.1. Thanks
to Gary Gregory.
-o Bump tests from commons-dbcp2 2.7.0 to 2.9.0. Thanks to
Gary Gregory.
-o Bump snakeyaml from 1.26 to 1.30 #68, #126, #137. Thanks
to Dependabot, Gary Gregory.
-o Bump commons.japicmp.version from 0.14.1 to 0.15.7.
Thanks to Gary Gregory.
-o Bump junit from 4.13 to 4.13.2 #78. Thanks to
Dependabot, Gary Gregory.
-o Bump Apache Commons VFS 2.6.0 -> 2.9.0. Thanks to Gary
Gregory.
-o Bump jackson-databind from 2.11.3 to 2.13.2.2 ,#88, #94,
#127, #159, #168, #173. Thanks to Dependabot.
-o Bump commons.animal-sniffer.version 1.19 -> 1.20. Thanks
to Gary Gregory.
-o Bump commons.javadoc.version from 3.1.1 to 3.4.0. Thanks
to Gary Gregory.
-o Bump org.dbunit:dbunit from 2.7.0 to 2.7.3, #167. Thanks
to Gary Gregory, Dependabot.
-o Bump tests to hamcrest v2.2 #143. Thanks to John Patrick.
-o Bump slf4j.version from 1.7.33 to 1.7.36 #166. Thanks to
Dependabot.
-o Bump mailapi from 1.6.6 to 2.0.1 #186. Thanks to
Dependabot.
-o Use GitHub Actions setup-java Maven cache property #190.
Thanks to sullis.
+* Bump commons-parent from 50 to 52. Thanks to Dependabot.
+* Bump mailapi from 1.6.4 to 1.6.7 #48. Thanks to
Dependabot, Gary Gregory.
+* Bump spotbugs-maven-plugin from 3.1.12.2 to 4.7.0.0,
#55, #75, #79, #93, #116, #183. Thanks to Dependabot, Gary Gregory.
+* Bump hsqldb from 2.5.0 to 2.5.2 #54, #128. Thanks to
Dependabot.
+* Bump commons-text from 1.8 to 1.9. Thanks to Gary
Gregory.
+* Bump servlet-api from 2.4 to 2.5 #58. Thanks to Gary
Gregory.
+* Bump maven-checkstyle-plugin from 3.1.0 to 3.1.2, #57,
#97. Thanks to Gary Gregory.
+* Bump commons-pool2 from 2.8.0 to 2.10.0, #61, #124.
Thanks to Dependabot, Gary Gregory.
+* Bump optional commons-codec from 1.14 to 1.15. Thanks to
Gary Gregory.
+* Bump checkstyle from 8.26 to 9.3, #66, #71, #90, #101,
#118, #121, #132, #155. Thanks to Dependabot, Gary Gregory.
+* Bump commons.jacoco.version 0.8.5 to 0.8.8 (Fixes Java
15 builds). Thanks to Gary Gregory.
+* Bump tests from commons-pool2 2.10.0 to 2.11.1. Thanks
to Gary Gregory.
+* Bump tests from commons-dbcp2 2.7.0 to 2.9.0. Thanks to
Gary Gregory.
+* Bump snakeyaml from 1.26 to 1.30 #68, #126, #137. Thanks
to Dependabot, Gary Gregory.
+* Bump commons.japicmp.version from 0.14.1 to 0.15.7.
Thanks to Gary Gregory.
+* Bump junit from 4.13 to 4.13.2 #78. Thanks to
Dependabot, Gary Gregory.
+* Bump Apache Commons VFS 2.6.0 -> 2.9.0. Thanks to Gary
Gregory.
+* Bump jackson-databind from 2.11.3 to 2.13.2.2 ,#88, #94,
#127, #159, #168, #173. Thanks to Dependabot.
+* Bump commons.animal-sniffer.version 1.19 -> 1.20. Thanks
to Gary Gregory.
+* Bump commons.javadoc.version from 3.1.1 to 3.4.0. Thanks
to Gary Gregory.
+* Bump org.dbunit:dbunit from 2.7.0 to 2.7.3, #167. Thanks
to Gary Gregory, Dependabot.
+* Bump tests to hamcrest v2.2 #143. Thanks to John Patrick.
+* Bump slf4j.version from 1.7.33 to 1.7.36 #166. Thanks to
Dependabot.
+* Bump mailapi from 1.6.6 to 2.0.1 #186. Thanks to
Dependabot.
+* Use GitHub Actions setup-java Maven cache property #190.
Thanks to sullis.
Historical list of changes:
https://commons.apache.org/proper/commons-configuration/changes-report.html
@@ -174,15 +254,15 @@ https://commons.apache.org/proper/commons-configuration/
Download it from
https://commons.apache.org/proper/commons-configuration/download_configuration.cgi
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.7
Release Notes
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -197,30 +277,36 @@ Minor release with new features and updated dependencies.
Changes in this version include:
-New features:
-o CONFIGURATION-765: Refactor XMLConfiguration.write(Writer) to add
XMLConfiguration.write(Writer, Transformer). Thanks to Gary Gregory.
-
-Fixed Bugs:
-o CONFIGURATION-761: Single argument DataConfiguration APIs always create
empty arrays. Thanks to Gary Gregory.
-o CONFIGURATION-767: NullPointerException in
XMLConfiguration#createTransformer() when no FileLocator is set. Thanks to Gary
Gregory.
-o CONFIGURATION-768: XMLConfiguration#write does not indent XML elements.
Thanks to Gary Gregory.
-o CONFIGURATION-771: Update com.fasterxml.jackson.core:jackson-databind
2.10.0 -> 2.10.1. Thanks to Gary Gregory.
-o CONFIGURATION-773: User's Guide > Properties files > Saving - small
documentation bugs #41. Thanks to Dan Dragut.
-
-Changes:
-o CONFIGURATION-762: Use variable arguments. Thanks to Gary Gregory.
-o Update ]com.puppycrawl.tools:checkstyle from 8.24 to
8.25. Thanks to Gary Gregory.
-o CONFIGURATION-763: Update com.fasterxml.jackson.core:jackson-databind from
2.9.9 to 2.10.0. Thanks to Gary Gregory.
-o [test] org.easymock:easymock 4.0.2 -> 4.1. Thanks to
Gary Gregory.
-o CONFIGURATION-775: Update Apache Commons VFS from 2.4.1 to 2.5.0. Thanks to
Gary Gregory.
-o CONFIGURATION-777: Update Apache Commons VFS from 2.5.0 to 2.6.0. Thanks to
Gary Gregory.
-o CONFIGURATION-778: Update optional Apache Commons Codec from 1.13 to 1.14.
Thanks to Gary Gregory.
-o Update tests from JUnit 4.12 to 4.13. Thanks to Gary
Gregory.
-o CONFIGURATION-779: Update optional jackson-databind from 2.10.1 to 2.10.2.
Thanks to Gary Gregory.
-o CONFIGURATION-783: Update com.fasterxml.jackson.core:jackson-databind from
2.10.2 to 2.10.3. Thanks to Gary Gregory.
-o CONFIGURATION-784: Update org.yaml:snakeyaml from 1.25 to 1.26 and tweak
parser configuration. Thanks to Gary Gregory.
-o CONFIGURATION-785: Update org.springframework:spring-* from 4.3.25.RELEASE
to 4.3.26.RELEASE. Thanks to Gary Gregory.
-o Update org.apache.commons:commons-parent from 48 to 50
Thanks to Rob Tompkins.
+New features
+------------
+
+* CONFIGURATION-765: Refactor XMLConfiguration.write(Writer) to add
XMLConfiguration.write(Writer, Transformer). Thanks to Gary Gregory.
+
+Fixed Bugs
+----------
+
+* CONFIGURATION-761: Single argument DataConfiguration APIs always create
empty arrays. Thanks to Gary Gregory.
+* CONFIGURATION-767: NullPointerException in
XMLConfiguration#createTransformer() when no FileLocator is set. Thanks to Gary
Gregory.
+* CONFIGURATION-768: XMLConfiguration#write does not indent XML elements.
Thanks to Gary Gregory.
+* CONFIGURATION-771: Update com.fasterxml.jackson.core:jackson-databind
2.10.0 -> 2.10.1. Thanks to Gary Gregory.
+* CONFIGURATION-773: User's Guide > Properties files > Saving - small
documentation bugs #41. Thanks to Dan Dragut.
+
+Changes
+-------
+
+* CONFIGURATION-762: Use variable arguments. Thanks to Gary Gregory.
+* Update ]com.puppycrawl.tools:checkstyle from 8.24 to
8.25. Thanks to Gary Gregory.
+* CONFIGURATION-763: Update com.fasterxml.jackson.core:jackson-databind from
2.9.9 to 2.10.0. Thanks to Gary Gregory.
+* [test] org.easymock:easymock 4.0.2 -> 4.1. Thanks to
Gary Gregory.
+* CONFIGURATION-775: Update Apache Commons VFS from 2.4.1 to 2.5.0. Thanks to
Gary Gregory.
+* CONFIGURATION-777: Update Apache Commons VFS from 2.5.0 to 2.6.0. Thanks to
Gary Gregory.
+* CONFIGURATION-778: Update optional Apache Commons Codec from 1.13 to 1.14.
Thanks to Gary Gregory.
+* Update tests from JUnit 4.12 to 4.13. Thanks to Gary
Gregory.
+* CONFIGURATION-779: Update optional jackson-databind from 2.10.1 to 2.10.2.
Thanks to Gary Gregory.
+* CONFIGURATION-783: Update com.fasterxml.jackson.core:jackson-databind from
2.10.2 to 2.10.3. Thanks to Gary Gregory.
+* CONFIGURATION-784: Update org.yaml:snakeyaml from 1.25 to 1.26 and tweak
parser configuration. Thanks to Gary Gregory.
+* CONFIGURATION-785: Update org.springframework:spring-* from 4.3.25.RELEASE
to 4.3.26.RELEASE. Thanks to Gary Gregory.
+* Update org.apache.commons:commons-parent from 48 to 50
Thanks to Rob Tompkins.
Historical list of changes:
https://commons.apache.org/proper/commons-configuration/changes-report.html
@@ -232,7 +318,7 @@ https://commons.apache.org/proper/commons-configuration/
Download it from
https://commons.apache.org/proper/commons-configuration/download_configuration.cgi
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.6
@@ -240,8 +326,8 @@ Release Notes
2019-09-13
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -256,30 +342,36 @@ Minor release with new features and updated dependencies.
Changes in this version include:
-New features:
-o Document "includeOptional" on the site. Thanks to Gary
Gregory.
-o CONFIGURATION-756: Allow for custom behavior to handle errors loading
included properties files. Thanks to Gary Gregory.
-
-Fixed Bugs:
-o CONFIGURATION-750: XMLPropertyListConfiguration cannot set arrays in the
correct plist form. Thanks to Jason Pickens, Gary Gregory, Emmanuel Bourg.
-o Fix Javadoc for
org.apache.commons.configuration2.PropertiesConfiguration.getIncludeOptional().
Thanks to Gary Gregory.
-o CONFIGURATION-760: Properties file using cyclical includes cause a
StackOverflowError instead of detecting the misconfiguration. Thanks to Gary
Gregory.
-
-Changes:
-o CONFIGURATION-751: Update Apache Commons Text from 1.6 to 1.7. Thanks to
Gary Gregory.
-o CONFIGURATION-752: Update Apache Commons VFS from 2.3 to 2.4.1. Thanks to
Gary Gregory.
-o CONFIGURATION-754: Update Apache Commons Text from 1.7 to 1.8. Thanks to
Gary Gregory.
-o CONFIGURATION-755: [CVE-2014-0114] Update Apache Commons BeanUtils from
1.9.3 to 1.9.4. Thanks to Gary Gregory.
-o Fix syntax in user guide documentation #33. Thanks to
Kevin Wang.
-o CONFIGURATION-757: Update org.yaml:snakeyaml from 1.24 to 1.25. Thanks to
Gary Gregory.
-o Update tests from org.apache.commons:commons-dbcp2 2.6.0
to 2.7.0. Thanks to Gary Gregory.
-o Update tests from org.apache.commons:commons-pool2 2.6.2
to 2.7.0. Thanks to Gary Gregory.
-o CONFIGURATION-758: Update commons-codec:commons-codec from 1.12 to 1.13.
Thanks to Gary Gregory.
-o Update tests from org.hsqldb:hsqldb 2.4.1 to 2.5.0.
Thanks to Gary Gregory.
-o Update tests from com.sun.mail:mailapi 1.6.3 to 1.6.4.
Thanks to Gary Gregory.
-o CONFIGURATION-759: Update Spring from 4.3.24.RELEASE to 4.3.25.RELEASE.
Thanks to Gary Gregory.
-o Update maven-checkstyle-plugin from 3.0.0 to 3.1.0.
Thanks to Gary Gregory.
-o Use current version of Checkstyle: 6.18 to 8.24. Thanks
to Gary Gregory.
+New features
+------------
+
+* Document "includeOptional" on the site. Thanks to Gary
Gregory.
+* CONFIGURATION-756: Allow for custom behavior to handle errors loading
included properties files. Thanks to Gary Gregory.
+
+Fixed Bugs
+----------
+
+* CONFIGURATION-750: XMLPropertyListConfiguration cannot set arrays in the
correct plist form. Thanks to Jason Pickens, Gary Gregory, Emmanuel Bourg.
+* Fix Javadoc for
org.apache.commons.configuration2.PropertiesConfiguration.getIncludeOptional().
Thanks to Gary Gregory.
+* CONFIGURATION-760: Properties file using cyclical includes cause a
StackOverflowError instead of detecting the misconfiguration. Thanks to Gary
Gregory.
+
+Changes
+-------
+
+* CONFIGURATION-751: Update Apache Commons Text from 1.6 to 1.7. Thanks to
Gary Gregory.
+* CONFIGURATION-752: Update Apache Commons VFS from 2.3 to 2.4.1. Thanks to
Gary Gregory.
+* CONFIGURATION-754: Update Apache Commons Text from 1.7 to 1.8. Thanks to
Gary Gregory.
+* CONFIGURATION-755: [CVE-2014-0114] Update Apache Commons BeanUtils from
1.9.3 to 1.9.4. Thanks to Gary Gregory.
+* Fix syntax in user guide documentation #33. Thanks to
Kevin Wang.
+* CONFIGURATION-757: Update org.yaml:snakeyaml from 1.24 to 1.25. Thanks to
Gary Gregory.
+* Update tests from org.apache.commons:commons-dbcp2 2.6.0
to 2.7.0. Thanks to Gary Gregory.
+* Update tests from org.apache.commons:commons-pool2 2.6.2
to 2.7.0. Thanks to Gary Gregory.
+* CONFIGURATION-758: Update commons-codec:commons-codec from 1.12 to 1.13.
Thanks to Gary Gregory.
+* Update tests from org.hsqldb:hsqldb 2.4.1 to 2.5.0.
Thanks to Gary Gregory.
+* Update tests from com.sun.mail:mailapi 1.6.3 to 1.6.4.
Thanks to Gary Gregory.
+* CONFIGURATION-759: Update Spring from 4.3.24.RELEASE to 4.3.25.RELEASE.
Thanks to Gary Gregory.
+* Update maven-checkstyle-plugin from 3.0.0 to 3.1.0.
Thanks to Gary Gregory.
+* Use current version of Checkstyle: 6.18 to 8.24. Thanks
to Gary Gregory.
Historical list of changes:
https://commons.apache.org/proper/commons-configuration/changes-report.html
@@ -291,15 +383,15 @@ https://commons.apache.org/proper/commons-configuration/
Download it from
https://commons.apache.org/proper/commons-configuration/download_configuration.cgi
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.5
Release Notes
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -312,19 +404,23 @@ Minor release with new features and updated dependencies.
Changes in this version include:
-Fixed Bugs:
-o CONFIGURATION-731: Allow user to specify the comments and separator chars.
Thanks to Shuai Zhang, Gary Gregory.
+Fixed Bugs
+----------
+
+* CONFIGURATION-731: Allow user to specify the comments and separator chars.
Thanks to Shuai Zhang, Gary Gregory.
+
+Changes
+-------
-Changes:
-o CONFIGURATION-738: Update Jackson from 2.9.7 to 2.9.8. Thanks to Gary
Gregory.
-o CONFIGURATION-739: Update Apache Commons Codec from 1.11 to 1.12. Thanks to
Gary Gregory.
-o CONFIGURATION-740: Update Apache Commons VFS from 2.2 to 2.3. Thanks to
Gary Gregory.
-o CONFIGURATION-741: Update Spring from 4.3.19 to 4.3.22. Thanks to Gary
Gregory.
-o CONFIGURATION-743: Update optional library snakeyaml from 1.23 to 1.24.
Thanks to Gary Gregory.
-o CONFIGURATION-747: Update Apache Commons Lang from 3.8.1 to 3.9. Thanks to
Gary Gregory.
-o CONFIGURATION-746: Update Jackson from 2.9.8 to 2.9.9. Thanks to Gary
Gregory.
-o CONFIGURATION-747: Update Spring from 4.3.22 to 4.3.24. Thanks to Gary
Gregory.
-o CONFIGURATION-745: Add the special key "includeoptional" for properties
files. Thanks to Gary Gregory.
+* CONFIGURATION-738: Update Jackson from 2.9.7 to 2.9.8. Thanks to Gary
Gregory.
+* CONFIGURATION-739: Update Apache Commons Codec from 1.11 to 1.12. Thanks to
Gary Gregory.
+* CONFIGURATION-740: Update Apache Commons VFS from 2.2 to 2.3. Thanks to
Gary Gregory.
+* CONFIGURATION-741: Update Spring from 4.3.19 to 4.3.22. Thanks to Gary
Gregory.
+* CONFIGURATION-743: Update optional library snakeyaml from 1.23 to 1.24.
Thanks to Gary Gregory.
+* CONFIGURATION-747: Update Apache Commons Lang from 3.8.1 to 3.9. Thanks to
Gary Gregory.
+* CONFIGURATION-746: Update Jackson from 2.9.8 to 2.9.9. Thanks to Gary
Gregory.
+* CONFIGURATION-747: Update Spring from 4.3.22 to 4.3.24. Thanks to Gary
Gregory.
+* CONFIGURATION-745: Add the special key "includeoptional" for properties
files. Thanks to Gary Gregory.
Historical list of changes:
https://commons.apache.org/proper/commons-configuration/changes-report.html
@@ -334,15 +430,15 @@ patches, or suggestions for improvement, see the Apache
Apache Commons Configura
https://commons.apache.org/proper/commons-configuration/
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.4
Release Notes
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -354,42 +450,42 @@ Minor release with new features and updated dependencies.
Changes in this version include:
-NEW FEATURES
-============
+New Features
+------------
-o CONFIGURATION-712: FileHandlerReloadingDetector now has a new refresh()
method to
+* CONFIGURATION-712: FileHandlerReloadingDetector now has a new refresh()
method to
initialize the reloading state from the underlying file.
This new
method is called by DefaultReloadingDetectorFactory when
a new detector
instance is created. This makes sure that a changed
configuration file
is directly detected on the first invocation of the
isReloadingRequired() method. Thanks to Rolland Hobbie.
-o CONFIGURATION-713: Configuration properties can now be converted to regular
expressions. Thanks to Lars W.
-o CONFIGURATION-715: With JupIOFactory a new IOFactory implementation is now
available that
+* CONFIGURATION-713: Configuration properties can now be converted to regular
expressions. Thanks to Lars W.
+* CONFIGURATION-715: With JupIOFactory a new IOFactory implementation is now
available that
implements handling of whitespace in a way closer to
java.util.Properties.
This class can be used when stricter compatibility with
Java standard
methods for reading and writing properties files is
needed. Thanks to Patrick Schmidt.
-o CONFIGURATION-716: JupIOFactory (introduced for CONFIGURATION-715) also
implements
+* CONFIGURATION-716: JupIOFactory (introduced for CONFIGURATION-715) also
implements
handling of escape sequences in a way closer to
java.util.Properties. Thanks to Patrick Schmidt.
-o CONFIGURATION-724: Add support for Commons Text 1.4 localhost string lookup
as a default lookup.
-o CONFIGURATION-726: Add support for Commons Text 1.5 new string lookups as
default lookups.
+* CONFIGURATION-724: Add support for Commons Text 1.4 localhost string lookup
as a default lookup.
+* CONFIGURATION-726: Add support for Commons Text 1.5 new string lookups as
default lookups.
-FIXED BUGS
-==========
+Fixed Bugs
+----------
-o CONFIGURATION-710: Fixed numerous typos in user guides. Thanks to thc202.
-o CONFIGURATION-711: Update Apache Commons Lang from 3.7 to 3.8.1.
-o CONFIGURATION-727: org.apache.commons.configuration2.DatabaseConfiguration
never closes result sets and statements.
+* CONFIGURATION-710: Fixed numerous typos in user guides. Thanks to thc202.
+* CONFIGURATION-711: Update Apache Commons Lang from 3.7 to 3.8.1.
+* CONFIGURATION-727: org.apache.commons.configuration2.DatabaseConfiguration
never closes result sets and statements.
-CHANGES
-=======
+Changes
+-------
-o CONFIGURATION-720: Replace use of deprecated Commons Lang string
substitution code for Commons Text.
-o CONFIGURATION-694: Update Java requirement from version 7 to 8.
-o CONFIGURATION-721: Update Jackson from 2.9.6 to 2.9.7.
-o CONFIGURATION-722: Update optional dependency snakeyaml from 1.21 to 1.23.
-o CONFIGURATION-723: Update optional Spring dependencies from 4.3.18.RELEASE
to 4.3.19.RELEASE.
-o CONFIGURATION-725: Update Apache Commons Text from 1.4 to 1.5.
-o CONFIGURATION-728: Update Apache Commons Text from 1.5 to 1.6.
+* CONFIGURATION-720: Replace use of deprecated Commons Lang string
substitution code for Commons Text.
+* CONFIGURATION-694: Update Java requirement from version 7 to 8.
+* CONFIGURATION-721: Update Jackson from 2.9.6 to 2.9.7.
+* CONFIGURATION-722: Update optional dependency snakeyaml from 1.21 to 1.23.
+* CONFIGURATION-723: Update optional Spring dependencies from 4.3.18.RELEASE
to 4.3.19.RELEASE.
+* CONFIGURATION-725: Update Apache Commons Text from 1.4 to 1.5.
+* CONFIGURATION-728: Update Apache Commons Text from 1.5 to 1.6.
Historical list of changes:
https://commons.apache.org/proper/commons-configuration/changes-report.html
@@ -399,16 +495,15 @@ patches, or suggestions for improvement, see the Apache
Apache Commons Configura
https://commons.apache.org/proper/commons-configuration/
-
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.3
Release Notes
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -424,64 +519,67 @@ as data types. The release is fully source and binary
compatible with version
Commons Configuration 2.3 requires Java 1.7 or higher.
New features
-============
-o CONFIGURATION-692
+------------
+
+* CONFIGURATION-692
ConversionExceptions thrown when accessing the properties of a configuration
now contain the original cause of the exception.
-o CONFIGURATION-693
+* CONFIGURATION-693
Configuration properties can now be converted to the data types File and
Path.
-o CONFIGURATION-698
+* CONFIGURATION-698
Add org.apache.commons.configuration2.MapConfiguration.toString().
-o CONFIGURATION-698
+* CONFIGURATION-698
Add toString() methods here and there to help debugging.
-o CONFIGURATION-701
+* CONFIGURATION-701
CompositeConfiguration now supports an addConfigurationFirst() method to add
child configurations with a higher priority.
Fixed Bugs
-==========
-o CONFIGURATION-652
+----------
+
+* CONFIGURATION-652
Root node attributes are now updated correctly when loading XML configuration
files.
-o CONFIGURATION-686
+* CONFIGURATION-686
JSONConfiguration can now handle list structures with complex objects as
elements.
-o CONFIGURATION-687
+* CONFIGURATION-687
Fixed a memory leak in CombinedConfigurationBuilder. Builder for the child
sources were created each time a new result configuration was requested; thus
the list with child builders got longer and longer. This also had an impact
on reloading because unnecessary reloading operations could be triggered. Now
it is guaranteed that child builders are created only once.
-o CONFIGURATION-688
+* CONFIGURATION-688
Fixed a bug related to the handling of multiple include files in
PropertiesConfiguration.
-o CONFIGURATION-690
+* CONFIGURATION-690
ExprLookup.getVariables() no longer returns null, but a copy of the current
variables of this lookup object.
-o CONFIGURATION-691
+* CONFIGURATION-691
ExprLookup now handles expressions that do not return a string result by
converting them to string.
-o CONFIGURATION-703
+* CONFIGURATION-703
XMLConfiguration now handles elements correctly whose value consists only of
whitespace if the xml:space attribute is set to preserve.
Other changes
-=============
-o CONFIGURATION-675
+-------------
+
+* CONFIGURATION-675
Added a .gitignore file to the project.
-o Some dependencies have been updated to their most recent versions. However,
+* Some dependencies have been updated to their most recent versions. However,
as no new features of these dependencies are used, the older versions should
still work. The following dependencies are affected:
o Update Apache Commons Lang dependency from 3.6 to 3.7.
@@ -499,15 +597,15 @@ patches, or suggestions for improvement, see the Apache
Apache Commons Configura
https://commons.apache.org/proper/commons-configuration/
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.2
Release Notes
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -523,65 +621,68 @@ source and binary compatible with version 2.1.1.
Commons Configuration 2.2 requires Java 1.7 or higher.
New features
-============
-o CONFIGURATION-666
+------------
+
+* CONFIGURATION-666
Add convenience ctor ConfigurationRuntimeException(String, Object...).
-o CONFIGURATION-665
+* CONFIGURATION-665
Add
org.apache.commons.configuration2.AbstractHierarchicalConfiguration.toString().
-o CONFIGURATION-664
+* CONFIGURATION-664
Add API
org.apache.commons.configuration2.tree.ImmutableNode.getChildren(String).
-o CONFIGURATION-660
+* CONFIGURATION-660
Add toString() methods here and there to help debugging.
-o CONFIGURATION-658
+* CONFIGURATION-658
Add API org.apache.commons.configuration2.DataConfiguration.getURI(String)
methods.
-o CONFIGURATION-656
+* CONFIGURATION-656
Added new YAMLConfiguration class to support configuration files in YAML
format.
-o CONFIGURATION-653
+* CONFIGURATION-653
ConfigurationUtils and ConfigurationConverter now offer better support for
immutable configurations.
-o CONFIGURATION-647
+* CONFIGURATION-647
INIConfiguration can now be configured to use a custom separator between
properties and values when writing an ini file.
-o CONFIGURATION-258
+* CONFIGURATION-258
Added new JSONConfiguration class to support configuration files in JSON
format.
Fixed Bugs
-==========
-o CONFIGURATION-671
+----------
+
+* CONFIGURATION-671
Fixed a NPE in INIConfiguration when saving a configuration with an empty
section.
-o CONFIGURATION-669
+* CONFIGURATION-669
The node model returned by SubnodeConfiguration.getNodeModel() has now the
correct root node set.
Other changes
-=============
-o CONFIGURATION-673
+-------------
+
+* CONFIGURATION-673
Added an Automatic-Module-Name header to the manifest for compatibility with
the Java 9 module system.
-o CONFIGURATION-669
+* CONFIGURATION-669
Update optional Spring dependency from 4.2.5.RELEASE to 4.3.9.RELEASE.
-o CONFIGURATION-667
+* CONFIGURATION-667
Update Apache Commons Lang dependency from 3.3.2 to 3.6.
-o CONFIGURATION-663
+* CONFIGURATION-663
Fixed a typo in the upgrade to 2.0 guide.
-o CONFIGURATION-661
+* CONFIGURATION-661
Update platform requirement from Java 6 to 7.
@@ -592,15 +693,15 @@ patches, or suggestions for improvement, see the Apache
Apache Commons Configura
https://commons.apache.org/proper/commons-configuration/
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.1.1
Release Notes
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -613,49 +714,51 @@ The release is fully source and binary compatible with
version 2.1.
Commons Configuration 2.1 requires Java 1.6 or higher.
Fixed Bugs
-==========
-o CONFIGURATION-649
+----------
+
+* CONFIGURATION-649
Improved the handling of lists defined by a string with delimiter characters
in XMLConfiguration. Such lists now retain their original format when the
configuration is saved.
-o CONFIGURATION-648
+* CONFIGURATION-648
Made the IOFactory property of PropertiesBuilderParameter compatible with the
most recent version of Commons BeanUtils. This version changed the handling
of properties starting with multiple uppercase letters.
-o CONFIGURATION-646
+* CONFIGURATION-646
PropertiesConfiguration now works correctly with the auto-save mode.
-o CONFIGURATION-644
+* CONFIGURATION-644
PropertiesConfigurationLayout no longer duplicates a header comment if a file
with another comment is loaded. Thanks to Andrew DeMaria.
-o CONFIGURATION-643
+* CONFIGURATION-643
Documentation improvements for the user's guide.
-o CONFIGURATION-641
+* CONFIGURATION-641
Improved documentation of FileBased interface. The Javadocs now state
explicitly that the methods should not be called by client code. Exception
handling in configuration classes implementing FileLocatorAware has been
improved.
-o CONFIGURATION-640
+* CONFIGURATION-640
PropertiesConfiguration now correctly unescapes some special characters that
are always escaped in Java properties files.
Other changes
-=============
-o CONFIGURATION-639
+-------------
+
+* CONFIGURATION-639
In the OSGi bundle manifest of the Commons Configuration bundle the package
imports for Spring packages are now marked as optional.
Thanks to Rico Neubauer.
-o CONFIGURATION-638
+* CONFIGURATION-638
Improved handling of temporary files and folders in unit tests.
Thanks to Ahmet Celik.
-o CONFIGURATION-627
+* CONFIGURATION-627
Updated dependency to Commons BeanUtils to version 1.9.3. This fixes an issue
with an exception stacktrace that was logged when a ConfigurationBuilder was
used.
@@ -668,14 +771,14 @@ patches, or suggestions for improvement, see the Apache
Apache Commons Configura
https://commons.apache.org/proper/commons-configuration/
-=============================================================================
+-----------------------------------------------------------------------------
Commons Configuration Package
Version 2.1
Release Notes
-INTRODUCTION
-============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -692,47 +795,50 @@ The release is fully source and binary compatible with
version 2.0.
Commons Configuration 2.1 requires Java 1.6 or higher.
New Features
-============
-o CONFIGURATION-636
+------------
+
+* CONFIGURATION-636
PropertiesConfigurationLayout now allows manipulating the order of keys when
the properties file is written.
-o CONFIGURATION-624
+* CONFIGURATION-624
Support Commons Configuration as PropertySource in Spring.
Fixed Bugs
-==========
-o CONFIGURATION-634
+----------
+
+* CONFIGURATION-634
HomeDirectoryLocationStrategy now works correctly in the mode that evaluates
the FileLocator's base path.
-o CONFIGURATION-633
+* CONFIGURATION-633
Interpolation was improved to better support properties with multiple values.
-o CONFIGURATION-632
+* CONFIGURATION-632
The methods getStringArray() and getList() of CompositeConfiguration now
support the interpolation of variables that reference properties with
multiple values.
-o CONFIGURATION-622
+* CONFIGURATION-622
Fixed a problem in INIConfiguration.write() with keys containing a separator
character. This separator had been duplicated. Such keys are now handled
correctly when the configuration is saved.
Other changes
-=============
-o CONFIGURATION-628
+-------------
+
+* CONFIGURATION-628
Support for the ant build was dropped.
-o CONFIGURATION-626
+* CONFIGURATION-626
ImmutableConfiguration.getArray() has been deprecated. Arrays can now be
queried using the generic get() method in a type-safe way.
-o CONFIGURATION-631
+* CONFIGURATION-631
Updated optional dependency to Apache Commons VFS from 2.0 to 2.1. (The older
version still works.)
-o CONFIGURATION-635
+* CONFIGURATION-635
Updated optional dependency to Apache Commons Codec from 1.9 to 1.10. (The
older version still works.)
@@ -744,14 +850,14 @@ on how to submit bug reports, patches, or suggestions for
improvement, see the
Apache Commons Configuration website:
https://commons.apache.org/proper/commons-configuration/
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.0
Release Notes
-INTRODUCTION
-============
+Introducing Apache Commons Configuration
+----------------------------------------
After a series of alpha and beta releases (please consult the corresponding
release notes below), this is the first final release for Apache Commons
@@ -777,37 +883,42 @@ new version. It can be found at
https://commons.apache.org/configuration/userguide/user_guide.html
-Changes:
-========
-o CONFIGURATION-621:
+Changes
+-------
+
+* CONFIGURATION-621:
Moved ConfigurationLogger class to io package to avoid cyclic dependencies
between packages.
-o CONFIGURATION-619:
+* CONFIGURATION-619:
CombinedConfigurationBuilder now supports inheritance of its parameters to
child configuration sources. This is enabled by default.
-o CONFIGURATION-615:
+* CONFIGURATION-615:
Changed generic types in the signatures of a MapConfiguration constructor
and AbstractConfiguration.getList(String, List). These changes were made in
version 1.10 as fixes for CONFIGURATION-557 and CONFIGURATION-558. But it
had been missed to merge them to trunk.
-Fixed Bugs:
-===========
-o CONFIGURATION-620:
+Fixed Bugs
+----------
+
+* CONFIGURATION-620:
Fixed two invalid examples in the user's guide for file-based configurations.
-o CONFIGURATION-618:
+* CONFIGURATION-618:
When using immutable configurations exceptions thrown by the wrapped
configuration came out as UndeclaredThrowableException. This has been fixed;
now the correct original exception is thrown.
Commons Configuration 2.0 requires Java 1.6 or higher.
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.0-beta2
Release Notes
+Introducing Apache Commons Configuration
+----------------------------------------
+
After the first beta release in June 2015 there has been some feedback from the
community resulting in (minor) adaptations of the API. In most cases, the
return values of methods have been changed to be more generic. There has also
@@ -822,28 +933,30 @@ Below is a list of all changes in this version. Please
refer to the clirr
report at
https://commons.apache.org/proper/commons-configuration/clirr-report.html
for information about changes which break binary compatibility.
-Changes:
-========
-o CONFIGURATION-614:
+Changes
+-------
+
+* CONFIGURATION-614:
References to Commons Logging have been removed from the Configuration API.
It is still possible to influence logging by making use of the new
ConfigurationLogger abstraction.
-o CONFIGURATION-612:
+* CONFIGURATION-612:
The return type of ConfigurationBuilder.getConfiguration() was changed from
Configuration to ImmutableConfiguration because this is the base interface
for all configuration objects. Thanks to Jon Weygand.
-o CONFIGURATION-608:
+* CONFIGURATION-608:
Adapted the return type of
ReloadingFileBasedConfigurationBuilder.configure().
-Fixed Bugs:
-===========
-o CONFIGURATION-609:
+Fixed Bugs
+----------
+
+* CONFIGURATION-609:
Fixed a bug in PropertiesConfiguration related to the loading of include
files. The FileHandler used for this purpose was not fully initialized.
-o CONFIGURATION-605:
+* CONFIGURATION-605:
XMLConfiguration no longer drops keys when list delimiter characters occur
in element values.
-o CONFIGURATION-604:
+* CONFIGURATION-604:
Fixed a problem in the conversion of a flat configuration to a hierarchical
one that could cause the loss of properties in a combined configuration
constructed by an override combiner.
@@ -857,12 +970,15 @@ on how to submit bug reports, patches, or suggestions for
improvement, see the
Apache Commons Configuration website:
https://commons.apache.org/proper/commons-configuration/
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.0-beta1
Release Notes
+Introducing Apache Commons Configuration
+----------------------------------------
+
This is the first beta release of Commons Configuration 2.0 after two alpha
versions. There has not been much feedback so far and no requests for API
changes. Therefore, we move forwards to a beta release indicating that the API
@@ -874,18 +990,22 @@ there has only be a single change: an obsolete interface
(which had been
overlooked during a major refactoring) was removed. So applications that are
using 2.0-alpha2 should be able to migrate to 2.0-beta1 without problems.
-Changes:
-========
-o CONFIGURATION-598: Removed obsolete ConfigurationBuilder interface in the
+Changes
+-------
+
+* CONFIGURATION-598: Removed obsolete ConfigurationBuilder interface in the
base package.
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.0-alpha2
Release Notes
+Introducing Apache Commons Configuration
+----------------------------------------
+
After version 2.0-alpha1 has been out for a while (the corresponding release
notes can be found below), this second alpha release contains a few number of
improvements and new features whose implementation required some changes on
@@ -896,20 +1016,22 @@ affected.
Below is a list of all changes in this version:
-New features:
-=============
-o CONFIGURATION-574: DefaultExpressionEngine can now be customized to match
+New features
+------------
+
+* CONFIGURATION-574: DefaultExpressionEngine can now be customized to match
configuration keys in a case-insensitive manner. This is
useful
for instance for dealing with Windows INI files.
-o CONFIGURATION-565: Added support for querying encoded properties.
-o CONFIGURATION-200: A size() method was added to the ImmutableConfiguration
interface.
+* CONFIGURATION-565: Added support for querying encoded properties.
+* CONFIGURATION-200: A size() method was added to the ImmutableConfiguration
interface.
-Fixed Bugs:
-===========
-o CONFIGURATION-564: PropertiesConfiguration now supports again properties
without a
+Fixed Bugs
+----------
+
+* CONFIGURATION-564: PropertiesConfiguration now supports again properties
without a
value and a separator character. The keys of such
properties
are added to the configuration with an empty String as
value.
-o CONFIGURATION-427: XMLPropertyListConfiguration can now save arrays in the
correct form.
+* CONFIGURATION-427: XMLPropertyListConfiguration can now save arrays in the
correct form.
Historical list of changes:
https://commons.apache.org/proper/commons-configuration/changes-report.html
@@ -918,12 +1040,15 @@ patches, or suggestions for improvement, see the Apache
Commons Configuration we
https://commons.apache.org/proper/commons-configuration/
-=============================================================================
+-----------------------------------------------------------------------------
Apache Commons Configuration
Version 2.0-alpha1
Release Notes
+Introducing Apache Commons Configuration
+----------------------------------------
+
This is the first alpha release for version 2.0 of Commons Configuration.
Version 2 is a major redesign of the Configuration API. It breaks compatibility
in many areas and, therefore, is not a drop-in replacement for Commons
@@ -947,171 +1072,175 @@ expected that there will still be some changes on the
public API.
Below is a list of all changes in this version:
-New features:
-=============
-o CONFIGURATION-579: A migration guide has been created which supports when
upgrading from
+New features
+------------
+
+* CONFIGURATION-579: A migration guide has been created which supports when
upgrading from
version 1.x to 2.0.
-o CONFIGURATION-559: It is now possible to define default values for
initialization
+* CONFIGURATION-559: It is now possible to define default values for
initialization
properties of configurations.
-o CONFIGURATION-551: The data type conversion mechanism has been made
extensible. There is a
+* CONFIGURATION-551: The data type conversion mechanism has been made
extensible. There is a
new interface ConversionHandler which controls the data
type conversions
available for a configuration object. By setting a
custom implementation,
conversions can be adapted or extended.
-o CONFIGURATION-550: Conversion to Character is now supported.
-o CONFIGURATION-541: Multi-file configurations are no longer restricted to
XML configuration
+* CONFIGURATION-550: Conversion to Character is now supported.
+* CONFIGURATION-541: Multi-file configurations are no longer restricted to
XML configuration
files. Arbitrary file-based configurations are now
supported.
-o CONFIGURATION-535: DatabaseConfiguration now provides get methods for
querying its
+* CONFIGURATION-535: DatabaseConfiguration now provides get methods for
querying its
properties defining the underlying database structures.
-o CONFIGURATION-533: DatabaseConfiguration now automatically converts CLOBs
to strings if
+* CONFIGURATION-533: DatabaseConfiguration now automatically converts CLOBs
to strings if
they appear in property values.
-o CONFIGURATION-525: PropertiesConfiguration now keeps a comment at the
bottom of a
+* CONFIGURATION-525: PropertiesConfiguration now keeps a comment at the
bottom of a
properties file. A new footer property was added for
reading and
writing this footer comment.
-o CONFIGURATION-519: Configuration objects are now created via configuration
builders. A new
+* CONFIGURATION-519: Configuration objects are now created via configuration
builders. A new
API for configuration builders has been added.
-o CONFIGURATION-517: Hierarchical configurations now provide methods to
obtain sub
+* CONFIGURATION-517: Hierarchical configurations now provide methods to
obtain sub
configurations for all child elements of a given key.
-o CONFIGURATION-514: Bean declarations now support constructor invocations.
-o CONFIGURATION-512: It is now possible to obtain an immutable view on a
Configuration or
+* CONFIGURATION-514: Bean declarations now support constructor invocations.
+* CONFIGURATION-512: It is now possible to obtain an immutable view on a
Configuration or
HierarchicalConfiguration object. New interfaces,
ImmutableConfiguration, and
ImmutableHierarchicalConfiguration have
been introduced.
-o CONFIGURATION-508: Generic get() methods have been added to the
Configuration interface.
+* CONFIGURATION-508: Generic get() methods have been added to the
Configuration interface.
These methods expect a target class and try to convert
the value of
the specified property to this target class.
-o CONFIGURATION-204: With the new reloading mechanism automatic and periodic
reloading checks
+* CONFIGURATION-204: With the new reloading mechanism automatic and periodic
reloading checks
can be performed.
-o CONFIGURATION-202: Reloading checks can now be performed in a background
thread.
+* CONFIGURATION-202: Reloading checks can now be performed in a background
thread.
-Fixed Bugs:
-===========
-o CONFIGURATION-582: Fixed a StringIndexOutOfBoundsException in
PropertiesConfigurationLayout
+Fixed Bugs
+----------
+
+* CONFIGURATION-582: Fixed a StringIndexOutOfBoundsException in
PropertiesConfigurationLayout
which was caused by lines containing only whitespace.
-o CONFIGURATION-572: When a CombinedConfiguration is cleared it removes
itself as change
+* CONFIGURATION-572: When a CombinedConfiguration is cleared it removes
itself as change
listener from all child configurations. This fixes a
possible memory
leak.
-o CONFIGURATION-570: Fixed a possible ConcurrentModificationException when a
SystemConfiguration
+* CONFIGURATION-570: Fixed a possible ConcurrentModificationException when a
SystemConfiguration
instance is passed to the append() or copy() methods.
-o CONFIGURATION-567: XMLBeanDeclaration now escapes node names before they
are used to
+* CONFIGURATION-567: XMLBeanDeclaration now escapes node names before they
are used to
determine nested properties. Thanks to Shen liang.
-Changes:
-o CONFIGURATION-591: Removed methods from ConfigurationConverter related to
ExtendedProperties.
+Changes
+-------
+
+* CONFIGURATION-591: Removed methods from ConfigurationConverter related to
ExtendedProperties.
This class is no longer supported by recent versions of
Commons
Collections.
-o CONFIGURATION-590: Removed Serializable interface from all configuration
implementations.
+* CONFIGURATION-590: Removed Serializable interface from all configuration
implementations.
Some configuration classes declared this interface
without being
actually serializable.
-o CONFIGURATION-588: The name of the top-level package and the maven
coordinates have been
+* CONFIGURATION-588: The name of the top-level package and the maven
coordinates have been
changed to allow a coexistence of Commons Configuration
1.x with 2.0.
-o CONFIGURATION-584: The event mechanism has been reworked. There is now a
generic event
+* CONFIGURATION-584: The event mechanism has been reworked. There is now a
generic event
listener interface which can be used to receive
notifications from
multiple types of event sources.
-o CONFIGURATION-578: The user's guide has been fully reworked to cover all
new and enhanced
+* CONFIGURATION-578: The user's guide has been fully reworked to cover all
new and enhanced
features of version 2.0.
-o CONFIGURATION-577: The dependency to Commons Collections is no longer
needed.
-o CONFIGURATION-576: A new abstract base class for hierarchical
configurations was introduced
+* CONFIGURATION-577: The dependency to Commons Collections is no longer
needed.
+* CONFIGURATION-576: A new abstract base class for hierarchical
configurations was introduced
which supports arbitrary hierarchical data structures.
The type of the
nodes used by the configuration can now be specified as
a generic type
argument. This makes the integration of other
hierarchical structures
easier.
-o CONFIGURATION-575: Hierarchical configurations now operate on immutable
structures.
+* CONFIGURATION-575: Hierarchical configurations now operate on immutable
structures.
Data is no longer represented by ConfigurationNode
objects. The
ImmutableNode class now serves as data container.
-o CONFIGURATION-573: XPathExpressionEngine can now deal with namespace
prefixes in node and
+* CONFIGURATION-573: XPathExpressionEngine can now deal with namespace
prefixes in node and
attribute names.
-o CONFIGURATION-563: The DefaultExpressionEngine class is now immutable. An
instance can be
+* CONFIGURATION-563: The DefaultExpressionEngine class is now immutable. An
instance can be
shared between multiple configuration objects.
-o CONFIGURATION-562: Improved the API of ExprLookup.
-o CONFIGURATION-555: Fixed a bug in the handling of the xml:space attribute in
+* CONFIGURATION-562: Improved the API of ExprLookup.
+* CONFIGURATION-555: Fixed a bug in the handling of the xml:space attribute in
XMLConfiguration. The attribute is now also applied to
the current
element, not only to sub elements.
-o CONFIGURATION-554: BeanHelper is no longer a static utility class.
Instances can be
+* CONFIGURATION-554: BeanHelper is no longer a static utility class.
Instances can be
created with a specific configuration of bean factories.
There is still
a default instance which can be obtained via the
BeanHelper.INSTANCE
field.
-o CONFIGURATION-553: The code for accessing configuration files has been
reworked. Methods
+* CONFIGURATION-553: The code for accessing configuration files has been
reworked. Methods
related to locating configuration files have been moved
from
ConfigurationUtils to a new FileLocatorUtils class.
Customizable
strategy classes (implementing the new
FileLocationStrategy) can be
used for searching for configuration files.
-o CONFIGURATION-546: BeanHelper can now process BeanDefinitions initializing
properties of
+* CONFIGURATION-546: BeanHelper can now process BeanDefinitions initializing
properties of
collection types of their target beans. Thanks to Justin
Couch.
-o CONFIGURATION-544: Added missing dependencies to build.xml. Thanks to
Oliver Kopp.
-o CONFIGURATION-542: The mechanism for synchronizing configurations has been
completely
+* CONFIGURATION-544: Added missing dependencies to build.xml. Thanks to
Oliver Kopp.
+* CONFIGURATION-542: The mechanism for synchronizing configurations has been
completely
redesigned. It is now based on Synchronizer objects
which can be
configured by client code. A new chapter was added to
the user's guide
regarding thread-safety of configurations.
-o CONFIGURATION-540: MapConfiguration now directly uses a Properties object
passed to its
+* CONFIGURATION-540: MapConfiguration now directly uses a Properties object
passed to its
constructor as data store rather than copying it. This
allows
SystemConfiguration to be connected to system
properties; i.e.
changing a property through SystemConfiguration
immediately affects
the corresponding system property.
-o CONFIGURATION-539: The deprecated INIConfiguration class was removed.
+* CONFIGURATION-539: The deprecated INIConfiguration class was removed.
HierarchicalINIConfiguration was renamed to
INIConfiguration.
-o CONFIGURATION-537: The deprecated ConfigurationFactory class was removed.
-o CONFIGURATION-536: File-based configurations are now implemented in a
different way.
+* CONFIGURATION-537: The deprecated ConfigurationFactory class was removed.
+* CONFIGURATION-536: File-based configurations are now implemented in a
different way.
The interfaces FileConfiguration and ReloadingStrategy
have been
removed, also the base classes AbstractFileConfiguration
and
AbstractHierarchicalFileConfiguration. They are replaced
by the
FileBased interface and the FileHandler class which
implements
central I/O functionality. Reloading is now in the
responsibility of
configuration builders.
-o CONFIGURATION-534: The includesAllowed property of PropertyConfiguration is
now independent
+* CONFIGURATION-534: The includesAllowed property of PropertyConfiguration is
now independent
from the existence of a base path.
-o CONFIGURATION-530: Concurrent access to configurations and reloading have
been completely
+* CONFIGURATION-530: Concurrent access to configurations and reloading have
been completely
redesigned. Because reloading is now handled by
configuration builders
there is no need to acquire a lock in order to protected
against a
reload operations.
-o CONFIGURATION-527: AbstractConfiguration.clearPropertyDirect() is now
abstract. Thanks to Matthias Richter.
-o CONFIGURATION-526: XMLPropertiesConfiguration now supports loading from and
saving to DOM
+* CONFIGURATION-527: AbstractConfiguration.clearPropertyDirect() is now
abstract. Thanks to Matthias Richter.
+* CONFIGURATION-526: XMLPropertiesConfiguration now supports loading from and
saving to DOM
nodes. Thanks to Oliver Kopp.
-o CONFIGURATION-524: Interpolation now works correctly after a configuration
was cloned.
+* CONFIGURATION-524: Interpolation now works correctly after a configuration
was cloned.
The ConfigurationInterpolator instance is now cloned,
too.
-o CONFIGURATION-521: ConfigurationUtils.fileFromUrl() now correctly handles
URL containing
+* CONFIGURATION-521: ConfigurationUtils.fileFromUrl() now correctly handles
URL containing
encoded percent characters. Thanks to Oliver Kopp.
-o CONFIGURATION-520: Support for reloading of configuration data has been
reworked.
-o CONFIGURATION-518: Classes and interfaces related to interpolation have
been slightly
+* CONFIGURATION-520: Support for reloading of configuration data has been
reworked.
+* CONFIGURATION-518: Classes and interfaces related to interpolation have
been slightly
reworked. ConfigurationInterpolator is now thread-safe.
There are
multiple ways to define the ConfigurationInterpolator
object to be
used by an AbstractConfiguration instance.
-o CONFIGURATION-516: PropertiesConfiguration no longer escapes double quotes
on saving.
-o CONFIGURATION-515: The visibility of some internal methods of
PropertiesConfiguration.PropertiesWriter
+* CONFIGURATION-516: PropertiesConfiguration no longer escapes double quotes
on saving.
+* CONFIGURATION-515: The visibility of some internal methods of
PropertiesConfiguration.PropertiesWriter
has been increased to protected. This simplifies the
implementation of
a custom escaping strategy.
-o CONFIGURATION-513: HierarchicalConfiguration is now an interface. The base
implementation
+* CONFIGURATION-513: HierarchicalConfiguration is now an interface. The base
implementation
class is named BaseHierarchicalConfiguration.
-o CONFIGURATION-506: Removed obsolete nested classes Node and NodeVisitor of
+* CONFIGURATION-506: Removed obsolete nested classes Node and NodeVisitor of
HierarchicalConfiguration. The related deprecated class
ConfigurationKey was removed, too.
-o CONFIGURATION-505: XMLConfiguration no longer supports attributes with
multiple values or
+* CONFIGURATION-505: XMLConfiguration no longer supports attributes with
multiple values or
list delimiter parsing in attributes. This feature was
complex and
error prone and brought little value to the user.
-o CONFIGURATION-504: SubnodeConfiguration now provides a new method for
clearing it and
+* CONFIGURATION-504: SubnodeConfiguration now provides a new method for
clearing it and
removing its root node from the parent configuration.
The method
HierarchicalConfiguration.configurationsAt() now returns
a list
of SubnodeConfiguration so that it is easier to make
direct use of
this feature.
-o CONFIGURATION-500: XMLConfiguration now adds attributes of elements
defining a list to
+* CONFIGURATION-500: XMLConfiguration now adds attributes of elements
defining a list to
all list nodes.
-o CONFIGURATION-496: Concurrent access to configurations and reloading have
been completely
+* CONFIGURATION-496: Concurrent access to configurations and reloading have
been completely
redesigned. This should reduce the amount of
synchronization.
-o CONFIGURATION-486: Removed some static fields for specifying global default
values.
+* CONFIGURATION-486: Removed some static fields for specifying global default
values.
Using static fields in this way is thread-hostile. There
are now
alternatives for setting default values.
-o CONFIGURATION-462: Updated dependency to Commons Lang from version 2.6 to
3.1.
-o CONFIGURATION-419: EventSource is now an interface. With BaseEventSource
there is a
+* CONFIGURATION-462: Updated dependency to Commons Lang from version 2.6 to
3.1.
+* CONFIGURATION-419: EventSource is now an interface. With BaseEventSource
there is a
default implementation.
-o CONFIGURATION-418: The handling of list delimiters and their escape
characters has been
+* CONFIGURATION-418: The handling of list delimiters and their escape
characters has been
reworked. A new ListDelimiterHandler interface was
introduced allowing
applications to customize the treatment of list
delimiters.
-o CONFIGURATION-330: Concurrent access to configurations has been reworked.
-o CONFIGURATION-153: It is now possible to define the strategy used for
locating
+* CONFIGURATION-330: Concurrent access to configurations has been reworked.
+* CONFIGURATION-153: It is now possible to define the strategy used for
locating
configuration files.
-o CONFIGURATION-136: Reloading can no longer corrupt a configuration
instance. This is now
+* CONFIGURATION-136: Reloading can no longer corrupt a configuration
instance. This is now
handled by a configuration builder; the original
configuration instance
is not modified.
-o CONFIGURATION-26: It is now possible to influence the conversion from a
container object
+* CONFIGURATION-26: It is now possible to influence the conversion from a
container object
(a collection or an array) to a single value (e.g. what
is returned by
getString() if the current property has multiple
values). Per default,
the first value is returned. By overriding methods of the
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 652cf9d7..27540f54 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -23,7 +23,7 @@
<author email="d...@commons.apache.org">Apache Commons Community</author>
</properties>
<body>
- <release version="2.10.0" date="20YY-MM-DD" description="Minor release
with new features and updated dependencies.">
+ <release version="2.10.0" date="2024-03-06" description="Minor release
with new features and updated dependencies.">
<!-- FIX -->
<action dev="ggregory" type="fix" due-to="step-security-bot, Gary
Gregory">[StepSecurity] ci: Harden GitHub Actions #307.</action>
<action dev="ggregory" type="fix" issue="CONFIGURATION-834"
due-to="Keith Barlow, Gary Gregory">ConfirgurationPropertySource doesn't supply
resolved values #309.</action>
diff --git a/src/changes/release-notes.vm b/src/changes/release-notes.vm
index bd8529ac..5b91025c 100644
--- a/src/changes/release-notes.vm
+++ b/src/changes/release-notes.vm
@@ -15,13 +15,12 @@
## specific language governing permissions and limitations
## under the License.
##
- Apache Commons Configuration
- Version ${version}
- Release Notes
+Apache Commons Configuration
+Version ${version}
+Release Notes
-
-INTRODUCTION:
-=============
+Introducing Apache Commons Configuration
+----------------------------------------
This document contains the release notes for this version of the Commons
Configuration component. It describes the changes since the previous version.
@@ -70,7 +69,7 @@ $release.description.replaceAll(" ", "
#else
#set($dueto="")
#end
-o $issue ${action}$dueto
+* $issue ${action}$dueto
#set($action="")
#set($issue="")
#set($dueto="")
@@ -82,28 +81,36 @@ No changes defined in this version.
Changes in this version include:
#if ($release.getActions('add').size() !=0)
-New features:
+New features
+------------
+
#foreach($actionItem in $release.getActions('add'))
#processaction()
#end
#end
#if ($release.getActions('fix').size() !=0)
-Fixed Bugs:
+Fixed Bugs
+----------
+
#foreach($actionItem in $release.getActions('fix'))
#processaction()
#end
#end
#if ($release.getActions('update').size() !=0)
-Changes:
+Changes
+-------
+
#foreach($actionItem in $release.getActions('update'))
#processaction()
#end
#end
#if ($release.getActions('remove').size() !=0)
-Removed:
+Removed
+-------
+
#foreach($actionItem in $release.getActions('remove'))
#processaction()
#end
@@ -120,3 +127,4 @@ ${project.url}
Download it from ${project.url}/download_configuration.cgi
+-----------------------------------------------------------------------------
diff --git a/src/site/xdoc/download_configuration.xml
b/src/site/xdoc/download_configuration.xml
index a49ddc24..f5428cc7 100644
--- a/src/site/xdoc/download_configuration.xml
+++ b/src/site/xdoc/download_configuration.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 Configuration</title>
- <author email="d...@commons.apache.org">Apache Commons Documentation
Team</author>
- </properties>
- <body>
- <section name="Download Apache Commons Configuration">
- <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 Configuration 2.9.0 (Java 8 or above)">
- <subsection name="Binaries">
- <table>
- <tr>
- <td><a
href="[preferred]/commons/configuration/binaries/commons-configuration2-2.9.0-bin.tar.gz">commons-configuration2-2.9.0-bin.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration2-2.9.0-bin.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration2-2.9.0-bin.tar.gz.asc";>pgp</a></td>
- </tr>
- <tr>
- <td><a
href="[preferred]/commons/configuration/binaries/commons-configuration2-2.9.0-bin.zip">commons-configuration2-2.9.0-bin.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration2-2.9.0-bin.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration2-2.9.0-bin.zip.asc";>pgp</a></td>
- </tr>
- </table>
- </subsection>
- <subsection name="Source">
- <table>
- <tr>
- <td><a
href="[preferred]/commons/configuration/source/commons-configuration2-2.9.0-src.tar.gz">commons-configuration2-2.9.0-src.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration2-2.9.0-src.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration2-2.9.0-src.tar.gz.asc";>pgp</a></td>
- </tr>
- <tr>
- <td><a
href="[preferred]/commons/configuration/source/commons-configuration2-2.9.0-src.zip">commons-configuration2-2.9.0-src.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration2-2.9.0-src.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration2-2.9.0-src.zip.asc";>pgp</a></td>
- </tr>
- </table>
- </subsection>
- </section>
- <section name="Apache Commons Configuration 1.10 (old 1.x version)">
- <subsection name="Binaries">
- <table>
- <tr>
- <td><a
href="[preferred]/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz">commons-configuration-1.10-bin.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.asc";>pgp</a></td>
- </tr>
- <tr>
- <td><a
href="[preferred]/commons/configuration/binaries/commons-configuration-1.10-bin.zip">commons-configuration-1.10-bin.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration-1.10-bin.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration-1.10-bin.zip.asc";>pgp</a></td>
- </tr>
- </table>
- </subsection>
- <subsection name="Source">
- <table>
- <tr>
- <td><a
href="[preferred]/commons/configuration/source/commons-configuration-1.10-src.tar.gz">commons-configuration-1.10-src.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration-1.10-src.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration-1.10-src.tar.gz.asc";>pgp</a></td>
- </tr>
- <tr>
- <td><a
href="[preferred]/commons/configuration/source/commons-configuration-1.10-src.zip">commons-configuration-1.10-src.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration-1.10-src.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration-1.10-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/configuration/">browse download area</a></li>
- <li><a
href="https://archive.apache.org/dist/commons/configuration/";>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 Configuration</title>
+ <author email="d...@commons.apache.org">Apache Commons Documentation
Team</author>
+ </properties>
+ <body>
+ <section name="Download Apache Commons Configuration">
+ <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 Configuration 2.10.0 (Java 8 or above)">
+ <subsection name="Binaries">
+ <table>
+ <tr>
+ <td><a
href="[preferred]/commons/configuration/binaries/commons-configuration2-2.10.0-bin.tar.gz">commons-configuration2-2.10.0-bin.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration2-2.10.0-bin.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration2-2.10.0-bin.tar.gz.asc";>pgp</a></td>
+ </tr>
+ <tr>
+ <td><a
href="[preferred]/commons/configuration/binaries/commons-configuration2-2.10.0-bin.zip">commons-configuration2-2.10.0-bin.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration2-2.10.0-bin.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration2-2.10.0-bin.zip.asc";>pgp</a></td>
+ </tr>
+ </table>
+ </subsection>
+ <subsection name="Source">
+ <table>
+ <tr>
+ <td><a
href="[preferred]/commons/configuration/source/commons-configuration2-2.10.0-src.tar.gz">commons-configuration2-2.10.0-src.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration2-2.10.0-src.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration2-2.10.0-src.tar.gz.asc";>pgp</a></td>
+ </tr>
+ <tr>
+ <td><a
href="[preferred]/commons/configuration/source/commons-configuration2-2.10.0-src.zip">commons-configuration2-2.10.0-src.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration2-2.10.0-src.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration2-2.10.0-src.zip.asc";>pgp</a></td>
+ </tr>
+ </table>
+ </subsection>
+ </section>
+ <section name="Apache Commons Configuration 1.10 (old 1.x version)">
+ <subsection name="Binaries">
+ <table>
+ <tr>
+ <td><a
href="[preferred]/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz">commons-configuration-1.10-bin.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.asc";>pgp</a></td>
+ </tr>
+ <tr>
+ <td><a
href="[preferred]/commons/configuration/binaries/commons-configuration-1.10-bin.zip">commons-configuration-1.10-bin.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration-1.10-bin.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/binaries/commons-configuration-1.10-bin.zip.asc";>pgp</a></td>
+ </tr>
+ </table>
+ </subsection>
+ <subsection name="Source">
+ <table>
+ <tr>
+ <td><a
href="[preferred]/commons/configuration/source/commons-configuration-1.10-src.tar.gz">commons-configuration-1.10-src.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration-1.10-src.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration-1.10-src.tar.gz.asc";>pgp</a></td>
+ </tr>
+ <tr>
+ <td><a
href="[preferred]/commons/configuration/source/commons-configuration-1.10-src.zip">commons-configuration-1.10-src.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration-1.10-src.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/configuration/source/commons-configuration-1.10-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/configuration/">browse download area</a></li>
+ <li><a
href="https://archive.apache.org/dist/commons/configuration/";>archives...</a></li>
+ </ul>
+ </section>
+ </body>
+</document>
diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml
index 3c1ac484..dd8f593d 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 Configuration Issue tracking</title>
- <author email="d...@commons.apache.org">Apache Commons Documentation
Team</author>
- </properties>
- <body>
-
- <section name="Apache Commons Configuration Issue tracking">
- <p>
- Apache Commons Configuration uses <a
href="https://issues.apache.org/jira/";>ASF JIRA</a> for tracking issues.
- See the <a
href="https://issues.apache.org/jira/browse/CONFIGURATION";>Apache Commons
Configuration 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 Configuration please do the following:
- <ol>
- <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310467&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=12310467&issuetype=1&priority=4&assignee=-1";>bug
report</a>
- or <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310467&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 Configuration 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=12310467&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4";>All
Open Apache Commons Configuration bugs</a></li>
- <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310467&sorter/field=issuekey&sorter/order=DESC&status=5&status=6";>All
Resolved Apache Commons Configuration bugs</a></li>
- <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310467&sorter/field=issuekey&sorter/order=DESC";>All
Apache Commons Configuration 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 Configuration Issue tracking</title>
+ <author email="d...@commons.apache.org">Apache Commons Documentation
Team</author>
+ </properties>
+ <body>
+
+ <section name="Apache Commons Configuration Issue tracking">
+ <p>
+ Apache Commons Configuration uses <a
href="https://issues.apache.org/jira/";>ASF JIRA</a> for tracking issues.
+ See the <a
href="https://issues.apache.org/jira/browse/CONFIGURATION";>Apache Commons
Configuration 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 Configuration please do the following:
+ <ol>
+ <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310467&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=12310467&issuetype=1&priority=4&assignee=-1";>bug
report</a>
+ or <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310467&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 Configuration 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=12310467&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4";>All
Open Apache Commons Configuration bugs</a></li>
+ <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310467&sorter/field=issuekey&sorter/order=DESC&status=5&status=6";>All
Resolved Apache Commons Configuration bugs</a></li>
+ <li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12310467&sorter/field=issuekey&sorter/order=DESC";>All
Apache Commons Configuration 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 b2aa0d9d..9dc5b09b 100644
--- a/src/site/xdoc/mail-lists.xml
+++ b/src/site/xdoc/mail-lists.xml
@@ -59,9 +59,9 @@ limitations under the License.
</p>
<p>
Questions related to the usage of Apache Commons Configuration 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/list.html?u...@commons.apache.org";>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/list.html?d...@commons.apache.org";>Developer
List</a>
is for questions and discussion related to the development of Apache
Commons Configuration.
<br />
Please do not cross-post; developers are also subscribed to the user
list.
@@ -70,8 +70,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 +107,11 @@ limitations under the License.
<td><a
href="mailto:user-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:user-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
<td><a
href="mailto:u...@commons.apache.org?subject=[configuration]";>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/list.html?u...@commons.apache.org";>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/user@commons.apache.org/";>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/user@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -125,12 +126,11 @@ limitations under the License.
<td><a
href="mailto:dev-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:dev-unsubscr...@commons.apache.org";>Unsubscribe</a></td>
<td><a
href="mailto:d...@commons.apache.org?subject=[configuration]";>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/list.html?d...@commons.apache.org";>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/dev@commons.apache.org/";>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/dev@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -145,10 +145,10 @@ limitations under the License.
<td><a
href="mailto:issues-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:issues-unsubscr...@commons.apache.org";>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/list.html?iss...@commons.apache.org";>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/issues@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -164,10 +164,10 @@ limitations under the License.
<td><a
href="mailto:commits-subscr...@commons.apache.org";>Subscribe</a></td>
<td><a
href="mailto:commits-unsubscr...@commons.apache.org";>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/list.html?commits@commons.apache.org";>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/commits@commons.apache.org/";>www.mail-archive.com</a>
</td>
</tr>
@@ -199,13 +199,11 @@ limitations under the License.
<td><a class="externalLink"
href="mailto:announce-subscr...@apache.org";>Subscribe</a></td>
<td><a class="externalLink"
href="mailto:announce-unsubscr...@apache.org";>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/list.html?annou...@apache.org";>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/announce@apache.org/";>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/announce@apache.org/";>www.mail-archive.com</a>
</td>
</tr>
</table>
