You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ma...@apache.org on 2022/06/30 03:58:00 UTC
[commons-configuration] branch release updated (f5404331 -> 59e51527)
This is an automated email from the ASF dual-hosted git repository.
mattjuntunen pushed a change to branch release
in repository https://gitbox.apache.org/repos/asf/commons-configuration.git
from f5404331 preparing 2.8-rc2
add 1b97e364 Use GitHub Actions setup-java Maven cache property
add 01a360d0 Merge branch 'pr-190'
add fe1d6269 normalizing version from 2.8 to 2.8.0 (reverting previous change)
add fe09a3c6 adding documentation for interpolation changes
add 41823fe1 adding links to runtime dependencies page
new 59e51527 merging doc updates from master
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
.github/workflows/coverage.yml | 7 +--
.github/workflows/maven.yml | 9 +---
README.md | 4 +-
RELEASE-NOTES.txt | 49 +++++++-----------
pom.xml | 6 +--
src/changes/changes.xml | 5 +-
.../configuration2/ImmutableConfiguration.java | 8 +--
.../PropertiesConfigurationLayout.java | 6 +--
.../builder/FileBasedBuilderProperties.java | 2 +-
.../configuration2/convert/PropertyConverter.java | 4 +-
.../interpol/ConfigurationInterpolator.java | 2 +-
.../commons/configuration2/io/FileHandler.java | 2 +-
.../commons/configuration2/io/FileSystem.java | 2 +-
.../configuration2/io/URLConnectionOptions.java | 2 +-
.../commons/configuration2/tree/ImmutableNode.java | 2 +-
src/site/site.xml | 3 +-
src/site/xdoc/dependencies.xml | 44 ++++++++--------
src/site/xdoc/download_configuration.xml | 26 +++++-----
src/site/xdoc/userguide/howto_basicfeatures.xml | 41 ++++++++++++++-
src/site/xdoc/userguide/upgradeto2_0.xml | 2 +-
src/site/xdoc/userguide/upgradeto2_x.xml | 58 ++++++++++++++++++++++
src/site/xdoc/userguide/user_guide.xml | 1 +
22 files changed, 183 insertions(+), 102 deletions(-)
create mode 100644 src/site/xdoc/userguide/upgradeto2_x.xml
[commons-configuration] 01/01: merging doc updates from master
Posted by ma...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
mattjuntunen pushed a commit to branch release
in repository https://gitbox.apache.org/repos/asf/commons-configuration.git
commit 59e5152722198526c6ffe5361de7d1a6a87275c7
Merge: f5404331 41823fe1
Author: Matt Juntunen <ma...@apache.org>
AuthorDate: Wed Jun 29 23:54:57 2022 -0400
merging doc updates from master
.github/workflows/coverage.yml | 7 +--
.github/workflows/maven.yml | 9 +---
README.md | 4 +-
RELEASE-NOTES.txt | 49 +++++++-----------
pom.xml | 6 +--
src/changes/changes.xml | 5 +-
.../configuration2/ImmutableConfiguration.java | 8 +--
.../PropertiesConfigurationLayout.java | 6 +--
.../builder/FileBasedBuilderProperties.java | 2 +-
.../configuration2/convert/PropertyConverter.java | 4 +-
.../interpol/ConfigurationInterpolator.java | 2 +-
.../commons/configuration2/io/FileHandler.java | 2 +-
.../commons/configuration2/io/FileSystem.java | 2 +-
.../configuration2/io/URLConnectionOptions.java | 2 +-
.../commons/configuration2/tree/ImmutableNode.java | 2 +-
src/site/site.xml | 3 +-
src/site/xdoc/dependencies.xml | 44 ++++++++--------
src/site/xdoc/download_configuration.xml | 26 +++++-----
src/site/xdoc/userguide/howto_basicfeatures.xml | 41 ++++++++++++++-
src/site/xdoc/userguide/upgradeto2_0.xml | 2 +-
src/site/xdoc/userguide/upgradeto2_x.xml | 58 ++++++++++++++++++++++
src/site/xdoc/userguide/user_guide.xml | 1 +
22 files changed, 183 insertions(+), 102 deletions(-)
diff --cc README.md
index f10d8bde,b862750c..a4b01b74
--- a/README.md
+++ b/README.md
@@@ -43,10 -43,10 +43,10 @@@
Apache Commons Configuration
===================
-[](https://travis-ci.org/apache/commons-configuration)
+[](https://github.com/apache/commons-configuration/actions)
[](https://app.codecov.io/gh/apache/commons-configuration)
[](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-configuration2/)
- [](https://javadoc.io/doc/org.apache.commons/commons-configuration2/2.8)
-[](https://javadoc.io/doc/org.apache.commons/commons-configuration2/2.7)
++[](https://javadoc.io/doc/org.apache.commons/commons-configuration2/2.8.0)
Tools to assist in the reading of configuration/preferences files in
various formats
@@@ -68,7 -68,7 +68,7 @@@ Alternatively you can pull it from the
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-configuration2</artifactId>
- <version>2.8</version>
- <version>2.7</version>
++ <version>2.8.0</version>
</dependency>
```
diff --cc RELEASE-NOTES.txt
index 5291654a,c759d1d2..1539427c
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@@ -1,127 -1,3 +1,114 @@@
+ Apache Commons Configuration
- Version 2.8
++ Version 2.8.0
+ Release Notes
+
+
+INTRODUCTION:
+=============
+
+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:
+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 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
+ 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-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 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.
++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.
- 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 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.
++ 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
++ 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:
+ 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 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:
+ 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 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 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 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.
+
+
+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_text.cgi
+
+=============================================================================
+
Apache Commons Configuration
Version 2.7
Release Notes
diff --cc pom.xml
index 6bbe2e24,c5166324..e86bb394
--- a/pom.xml
+++ b/pom.xml
@@@ -24,7 -24,7 +24,7 @@@
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>commons-configuration2</artifactId>
- <version>2.8</version>
- <version>2.8.0-SNAPSHOT</version>
++ <version>2.8.0</version>
<name>Apache Commons Configuration</name>
<inceptionYear>2001</inceptionYear>
@@@ -607,11 -607,11 +607,11 @@@
<!-- Commons Release Plugin -->
<commons.bc.version>2.7</commons.bc.version>
- <commons.rc.version>RC2</commons.rc.version>
- <commons.rc.version>RC1</commons.rc.version>
++ <commons.rc.version>RC3</commons.rc.version>
<commons.release.isDistModule>true</commons.release.isDistModule>
<commons.distSvnStagingUrl>scm:svn:https://dist.apache.org/repos/dist/dev/commons/${commons.componentid}</commons.distSvnStagingUrl>
- <commons.releaseManagerName>Rob Tompkins</commons.releaseManagerName>
- <commons.releaseManagerKey>B6E73D84EA4FCC47166087253FAAD2CD5ECBB314</commons.releaseManagerKey>
+ <commons.releaseManagerName>Matt Juntunen</commons.releaseManagerName>
+ <commons.releaseManagerKey>7DD53AEFEDF1C3D392B51EBE346F4FCECFB70B1A</commons.releaseManagerKey>
</properties>
<build>
diff --cc src/changes/changes.xml
index 465d5aab,b80b68c5..a7dda246
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@@ -21,7 -21,7 +21,7 @@@
<author email="dev@commons.apache.org">Apache Commons Community</author>
</properties>
<body>
- <release version="2.8" date="2022-06-26"
- <release version="2.8.0" date="2020-MM-DD"
++ <release version="2.8.0" date="2022-07-05"
description="Minor release with new features and updated dependencies.">
<!-- FIX -->
<action issue="CONFIGURATION-753" type="fix" dev="mattjuntunen">
diff --cc src/site/xdoc/download_configuration.xml
index e4164dd1,177b4402..b4461122
--- a/src/site/xdoc/download_configuration.xml
+++ b/src/site/xdoc/download_configuration.xml
@@@ -1,144 -1,144 +1,144 @@@
-<?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="dev@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="http://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://www.apache.org/dist/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.7 (reworked 2.x version)">
+<?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="dev@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://www.apache.org/dist/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.8 (reworked 2.x version)">
++ <section name="Apache Commons Configuration 2.8.0 (reworked 2.x version)">
<subsection name="Binaries">
<table>
<tr>
- <td><a href="[preferred]/commons/configuration/binaries/commons-configuration2-2.8-bin.tar.gz">commons-configuration2-2.8-bin.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.8-bin.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.8-bin.tar.gz.asc">pgp</a></td>
- <td><a href="[preferred]/commons/configuration/binaries/commons-configuration2-2.7-bin.tar.gz">commons-configuration2-2.7-bin.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.7-bin.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.7-bin.tar.gz.asc">pgp</a></td>
++ <td><a href="[preferred]/commons/configuration/binaries/commons-configuration2-2.8.0-bin.tar.gz">commons-configuration2-2.8.0-bin.tar.gz</a></td>
++ <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.8.0-bin.tar.gz.sha512">sha512</a></td>
++ <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.8.0-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/configuration/binaries/commons-configuration2-2.8-bin.zip">commons-configuration2-2.8-bin.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.8-bin.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.8-bin.zip.asc">pgp</a></td>
- <td><a href="[preferred]/commons/configuration/binaries/commons-configuration2-2.7-bin.zip">commons-configuration2-2.7-bin.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.7-bin.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.7-bin.zip.asc">pgp</a></td>
++ <td><a href="[preferred]/commons/configuration/binaries/commons-configuration2-2.8.0-bin.zip">commons-configuration2-2.8.0-bin.zip</a></td>
++ <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.8.0-bin.zip.sha512">sha512</a></td>
++ <td><a href="https://www.apache.org/dist/commons/configuration/binaries/commons-configuration2-2.8.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.8-src.tar.gz">commons-configuration2-2.8-src.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.8-src.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.8-src.tar.gz.asc">pgp</a></td>
- <td><a href="[preferred]/commons/configuration/source/commons-configuration2-2.7-src.tar.gz">commons-configuration2-2.7-src.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.7-src.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.7-src.tar.gz.asc">pgp</a></td>
++ <td><a href="[preferred]/commons/configuration/source/commons-configuration2-2.8.0-src.tar.gz">commons-configuration2-2.8.0-src.tar.gz</a></td>
++ <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.8.0-src.tar.gz.sha512">sha512</a></td>
++ <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.8.0-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/configuration/source/commons-configuration2-2.8-src.zip">commons-configuration2-2.8-src.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.8-src.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.8-src.zip.asc">pgp</a></td>
- <td><a href="[preferred]/commons/configuration/source/commons-configuration2-2.7-src.zip">commons-configuration2-2.7-src.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.7-src.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.7-src.zip.asc">pgp</a></td>
++ <td><a href="[preferred]/commons/configuration/source/commons-configuration2-2.8.0-src.zip">commons-configuration2-2.8.0-src.zip</a></td>
++ <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.8.0-src.zip.sha512">sha512</a></td>
++ <td><a href="https://www.apache.org/dist/commons/configuration/source/commons-configuration2-2.8.0-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>