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:01 UTC
[commons-configuration] 01/01: merging doc updates from master
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
===================
-[![Build Status](https://travis-ci.org/apache/commons-configuration.svg)](https://travis-ci.org/apache/commons-configuration)
+[![GitHub Actions Status](https://github.com/apache/commons-configuration/workflows/Java%20CI/badge.svg)](https://github.com/apache/commons-configuration/actions)
[![Coverage Status](https://codecov.io/gh/apache/commons-configuration/branch/master/graph/badge.svg)](https://app.codecov.io/gh/apache/commons-configuration)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-configuration2/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-configuration2/)
- [![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-configuration2/2.8.svg)](https://javadoc.io/doc/org.apache.commons/commons-configuration2/2.8)
-[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-configuration2/2.7.svg)](https://javadoc.io/doc/org.apache.commons/commons-configuration2/2.7)
++[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-configuration2/2.8.0.svg)](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>