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>