You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Gary Gregory <ga...@gmail.com> on 2022/06/20 14:22:53 UTC

Re: [commons-configuration] 02/02: updating release docs

There is already a branch called "release". I think that using one branch
per release is just clutter IMO.

Gary

On Sun, Jun 19, 2022, 23:13 <ma...@apache.org> wrote:

> This is an automated email from the ASF dual-hosted git repository.
>
> mattjuntunen pushed a commit to branch 2.8.0-release
> in repository
> https://gitbox.apache.org/repos/asf/commons-configuration.git
>
> commit 6434507226c639a41d45af3be26197f8e04922ec
> Author: Matt Juntunen <ma...@apache.org>
> AuthorDate: Sun Jun 19 23:12:36 2022 -0400
>
>     updating release docs
> ---
>  RELEASE-NOTES.txt                        | 126 +++++++++++++++
>  src/changes/changes.xml                  |   2 +-
>  src/site/xdoc/building.xml               |   4 +-
>  src/site/xdoc/download_configuration.xml | 264
> +++++++++++++++----------------
>  4 files changed, 260 insertions(+), 136 deletions(-)
>
> diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
> index c759d1d2..706f09fe 100644
> --- a/RELEASE-NOTES.txt
> +++ b/RELEASE-NOTES.txt
> @@ -1,3 +1,127 @@
> +                        Apache Commons Configuration
> +                        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 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-808:  DefaultListDelimiterHandler.escapeList working only
> for List>String< #137. Thanks to cigaly.
> +o                     Use final #141. Thanks to Arturo Bernal.
> +o                     Replace test asserts by simpler but equivalent
> calls. #139 Thanks to Arturo Bernal.
> +o CONFIGURATION-764:  Single Variable Interpolation #182. Thanks to Ning
> Zhang, Matt Juntunen, Bruno P. Kinoshita,
> +                      Gary Gregory.
> +o                     Implement proper concurrency in ConstantLookup.
> Thanks to Gary Gregory.
> +o CONFIGURATION-813:  Support new namespace jakarta.mail.* used by
> javamail 2.0+ (first release October 2020) #186.
> +                      Thanks to Dependabot.
> +
> +Changes:
> +o                     Unclosed file handle when reading config from JAR
> file URL.
> +                      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                     Bump Slf4j test dependencies:
> +                      org.slf4j:slf4j-api 1.7.26 -> 1.7.33,
> +                      org.slf4j:slf4j-ext 1.7.26 -> 1.7.33,
> +                      org.slf4j:slf4j-log4j12 1.7.26 -> 1.7.33,
> +                      org.slf4j:slf4j-nop 1.7.26 -> 1.7.33. Thanks to
> Gary Gregory.
> +o                     Bump commons-parent from 50 to 52. Thanks to
> Dependabot.
> +o                     Bump mailapi from 1.6.4 to 1.6.7 #48. Thanks to
> Dependabot, Gary Gregory.
> +o                     Bump spotbugs-maven-plugin from 3.1.12.2 to
> 4.7.0.0, #55, #75, #79, #93, #116, #183. Thanks to
> +                      Dependabot, Gary Gregory.
> +o                     Bump hsqldb from 2.5.0 to 2.5.2 #54, #128. Thanks
> to Dependabot.
> +o                     Bump commons-text from 1.8 to 1.9. Thanks to Gary
> Gregory.
> +o                     Bump servlet-api from 2.4 to 2.5 #58. Thanks to
> Gary Gregory.
> +o                     Bump maven-checkstyle-plugin from 3.1.0 to 3.1.2,
> #57, #97. Thanks to Gary Gregory.
> +o                     Bump commons-pool2 from 2.8.0 to 2.10.0, #61, #124.
> Thanks to Dependabot, Gary Gregory.
> +o                     Bump optional commons-codec from 1.14 to 1.15.
> Thanks to Gary Gregory.
> +o                     Bump checkstyle from 8.26 to 9.3, #66, #71, #90,
> #101, #118, #121, #132, #155. Thanks to
> +                      Dependabot, Gary Gregory.
> +o                     Bump commons.jacoco.version 0.8.5 to 0.8.8 (Fixes
> Java 15 builds). Thanks to Gary Gregory.
> +o                     Bump tests from commons-pool2 2.10.0 to 2.11.1.
> Thanks to Gary Gregory.
> +o                     Bump tests from commons-dbcp2 2.7.0 to 2.9.0.
> Thanks to Gary Gregory.
> +o                     Bump snakeyaml from 1.26 to 1.30 #68, #126, #137.
> Thanks to Dependabot, Gary Gregory.
> +o                     Bump commons.japicmp.version from 0.14.1 to 0.15.7.
> Thanks to Gary Gregory.
> +o                     Bump junit from 4.13 to 4.13.2 #78. Thanks to
> Dependabot, Gary Gregory.
> +o                     Bump Apache Commons VFS 2.6.0 -> 2.9.0. Thanks to
> Gary Gregory.
> +o                     Bump jackson-databind from 2.11.3 to 2.13.2.2 ,#88,
> #94, #127, #159, #168, #173. Thanks to
> +                      Dependabot.
> +o                     Bump commons.animal-sniffer.version 1.19 -> 1.20.
> Thanks to Gary Gregory.
> +o                     Bump commons.javadoc.version from 3.1.1 to 3.4.0.
> Thanks to Gary Gregory.
> +o                     Bump org.dbunit:dbunit from 2.7.0 to 2.7.3, #167.
> Thanks to Gary Gregory, Dependabot.
> +o                     Bump tests to hamcrest v2.2 #143. Thanks to John
> Patrick.
> +o                     Bump slf4j.version from 1.7.33 to 1.7.36 #166.
> Thanks to Dependabot.
> +o                     Bump mailapi from 1.6.6 to 2.0.1 #186. Thanks to
> Dependabot.
> +
> +
> +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
> @@ -946,3 +1070,5 @@ For complete information on Apache Commons
> Configuration, including instructions
>  patches, or suggestions for improvement, see the Apache Commons
> Configuration website:
>
>  https://commons.apache.org/proper/commons-configuration/
> +
> +
> diff --git a/src/changes/changes.xml b/src/changes/changes.xml
> index 2c416023..70a00513 100644
> --- a/src/changes/changes.xml
> +++ b/src/changes/changes.xml
> @@ -21,7 +21,7 @@
>      <author email="dev@commons.apache.org">Apache Commons
> Community</author>
>    </properties>
>    <body>
> -    <release version="2.8.0" date="2020-MM-DD"
> +    <release version="2.8.0" date="2022-06-25"
>               description="Minor release with new features and updated
> dependencies.">
>         <!-- FIX -->
>         <action issue="CONFIGURATION-753" type="fix" dev="mattjuntunen">
> diff --git a/src/site/xdoc/building.xml b/src/site/xdoc/building.xml
> index e07e6e82..96852dd2 100644
> --- a/src/site/xdoc/building.xml
> +++ b/src/site/xdoc/building.xml
> @@ -34,13 +34,11 @@
>              "mvn install". This will compile the source and tests, run
> the tests, and then
>              package the jar. The jar will also be copied into the local
> maven repository
>              for use by other builds. According to the minimum Java
> version of
> -            Commons Configuration, this build requires a JDK 1.6 or
> higher.
> +            Commons Configuration, this build requires a JDK 8 or higher.
>            </p>
>            <p>
>              To build the web site run "mvn site". When it completes the
> web site will reside in
>              the target/site directory and may be viewed by opening
> target/site/index.html.
> -            Note that due to a dependency to a maven reporting plugin,
> the build of the site
> -            requires JDK 1.7 or higher.
>            </p>
>          </section>
>      </body>
> diff --git a/src/site/xdoc/download_configuration.xml
> b/src/site/xdoc/download_configuration.xml
> index 177b4402..b4461122 100644
> --- a/src/site/xdoc/download_configuration.xml
> +++ b/src/site/xdoc/download_configuration.xml
> @@ -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.0 (reworked 2.x
> version)">
>        <subsection name="Binaries">
>          <table>
>            <tr>
> -              <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.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.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.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>
> @@ -148,12 +148,12 @@ limitations under the License.
>          <table>
>            <tr>
>                <td><a
> href="[preferred]/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz">commons-configuration-1.10-bin.tar.gz</a></td>
> -              <td><a href="
> https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.sha256
> ">sha256</a></td>
> +              <td><a href="
> https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.sha512
> ">sha512</a></td>
>                <td><a href="
> https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.asc
> ">pgp</a></td>
>            </tr>
>            <tr>
>                <td><a
> href="[preferred]/commons/configuration/binaries/commons-configuration-1.10-bin.zip">commons-configuration-1.10-bin.zip</a></td>
> -              <td><a href="
> https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.zip.sha256
> ">sha256</a></td>
> +              <td><a href="
> https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.zip.sha512
> ">sha512</a></td>
>                <td><a href="
> https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.zip.asc
> ">pgp</a></td>
>            </tr>
>          </table>
> @@ -162,12 +162,12 @@ limitations under the License.
>          <table>
>            <tr>
>                <td><a
> href="[preferred]/commons/configuration/source/commons-configuration-1.10-src.tar.gz">commons-configuration-1.10-src.tar.gz</a></td>
> -              <td><a href="
> https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.tar.gz.sha256
> ">sha256</a></td>
> +              <td><a href="
> https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.tar.gz.sha512
> ">sha512</a></td>
>                <td><a href="
> https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.tar.gz.asc
> ">pgp</a></td>
>            </tr>
>            <tr>
>                <td><a
> href="[preferred]/commons/configuration/source/commons-configuration-1.10-src.zip">commons-configuration-1.10-src.zip</a></td>
> -              <td><a href="
> https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.zip.sha256
> ">sha256</a></td>
> +              <td><a href="
> https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.zip.sha512
> ">sha512</a></td>
>                <td><a href="
> https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.zip.asc
> ">pgp</a></td>
>            </tr>
>          </table>
>
>

Re: [commons-configuration] 02/02: updating release docs

Posted by Matt Juntunen <ma...@gmail.com>.
Sounds good. I've switched branches.
-Matt J

On Mon, Jun 20, 2022 at 10:23 AM Gary Gregory <ga...@gmail.com> wrote:
>
> There is already a branch called "release". I think that using one branch
> per release is just clutter IMO.
>
> Gary
>
> On Sun, Jun 19, 2022, 23:13 <ma...@apache.org> wrote:
>
> > This is an automated email from the ASF dual-hosted git repository.
> >
> > mattjuntunen pushed a commit to branch 2.8.0-release
> > in repository
> > https://gitbox.apache.org/repos/asf/commons-configuration.git
> >
> > commit 6434507226c639a41d45af3be26197f8e04922ec
> > Author: Matt Juntunen <ma...@apache.org>
> > AuthorDate: Sun Jun 19 23:12:36 2022 -0400
> >
> >     updating release docs
> > ---
> >  RELEASE-NOTES.txt                        | 126 +++++++++++++++
> >  src/changes/changes.xml                  |   2 +-
> >  src/site/xdoc/building.xml               |   4 +-
> >  src/site/xdoc/download_configuration.xml | 264
> > +++++++++++++++----------------
> >  4 files changed, 260 insertions(+), 136 deletions(-)
> >
> > diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
> > index c759d1d2..706f09fe 100644
> > --- a/RELEASE-NOTES.txt
> > +++ b/RELEASE-NOTES.txt
> > @@ -1,3 +1,127 @@
> > +                        Apache Commons Configuration
> > +                        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 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-808:  DefaultListDelimiterHandler.escapeList working only
> > for List>String< #137. Thanks to cigaly.
> > +o                     Use final #141. Thanks to Arturo Bernal.
> > +o                     Replace test asserts by simpler but equivalent
> > calls. #139 Thanks to Arturo Bernal.
> > +o CONFIGURATION-764:  Single Variable Interpolation #182. Thanks to Ning
> > Zhang, Matt Juntunen, Bruno P. Kinoshita,
> > +                      Gary Gregory.
> > +o                     Implement proper concurrency in ConstantLookup.
> > Thanks to Gary Gregory.
> > +o CONFIGURATION-813:  Support new namespace jakarta.mail.* used by
> > javamail 2.0+ (first release October 2020) #186.
> > +                      Thanks to Dependabot.
> > +
> > +Changes:
> > +o                     Unclosed file handle when reading config from JAR
> > file URL.
> > +                      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                     Bump Slf4j test dependencies:
> > +                      org.slf4j:slf4j-api 1.7.26 -> 1.7.33,
> > +                      org.slf4j:slf4j-ext 1.7.26 -> 1.7.33,
> > +                      org.slf4j:slf4j-log4j12 1.7.26 -> 1.7.33,
> > +                      org.slf4j:slf4j-nop 1.7.26 -> 1.7.33. Thanks to
> > Gary Gregory.
> > +o                     Bump commons-parent from 50 to 52. Thanks to
> > Dependabot.
> > +o                     Bump mailapi from 1.6.4 to 1.6.7 #48. Thanks to
> > Dependabot, Gary Gregory.
> > +o                     Bump spotbugs-maven-plugin from 3.1.12.2 to
> > 4.7.0.0, #55, #75, #79, #93, #116, #183. Thanks to
> > +                      Dependabot, Gary Gregory.
> > +o                     Bump hsqldb from 2.5.0 to 2.5.2 #54, #128. Thanks
> > to Dependabot.
> > +o                     Bump commons-text from 1.8 to 1.9. Thanks to Gary
> > Gregory.
> > +o                     Bump servlet-api from 2.4 to 2.5 #58. Thanks to
> > Gary Gregory.
> > +o                     Bump maven-checkstyle-plugin from 3.1.0 to 3.1.2,
> > #57, #97. Thanks to Gary Gregory.
> > +o                     Bump commons-pool2 from 2.8.0 to 2.10.0, #61, #124.
> > Thanks to Dependabot, Gary Gregory.
> > +o                     Bump optional commons-codec from 1.14 to 1.15.
> > Thanks to Gary Gregory.
> > +o                     Bump checkstyle from 8.26 to 9.3, #66, #71, #90,
> > #101, #118, #121, #132, #155. Thanks to
> > +                      Dependabot, Gary Gregory.
> > +o                     Bump commons.jacoco.version 0.8.5 to 0.8.8 (Fixes
> > Java 15 builds). Thanks to Gary Gregory.
> > +o                     Bump tests from commons-pool2 2.10.0 to 2.11.1.
> > Thanks to Gary Gregory.
> > +o                     Bump tests from commons-dbcp2 2.7.0 to 2.9.0.
> > Thanks to Gary Gregory.
> > +o                     Bump snakeyaml from 1.26 to 1.30 #68, #126, #137.
> > Thanks to Dependabot, Gary Gregory.
> > +o                     Bump commons.japicmp.version from 0.14.1 to 0.15.7.
> > Thanks to Gary Gregory.
> > +o                     Bump junit from 4.13 to 4.13.2 #78. Thanks to
> > Dependabot, Gary Gregory.
> > +o                     Bump Apache Commons VFS 2.6.0 -> 2.9.0. Thanks to
> > Gary Gregory.
> > +o                     Bump jackson-databind from 2.11.3 to 2.13.2.2 ,#88,
> > #94, #127, #159, #168, #173. Thanks to
> > +                      Dependabot.
> > +o                     Bump commons.animal-sniffer.version 1.19 -> 1.20.
> > Thanks to Gary Gregory.
> > +o                     Bump commons.javadoc.version from 3.1.1 to 3.4.0.
> > Thanks to Gary Gregory.
> > +o                     Bump org.dbunit:dbunit from 2.7.0 to 2.7.3, #167.
> > Thanks to Gary Gregory, Dependabot.
> > +o                     Bump tests to hamcrest v2.2 #143. Thanks to John
> > Patrick.
> > +o                     Bump slf4j.version from 1.7.33 to 1.7.36 #166.
> > Thanks to Dependabot.
> > +o                     Bump mailapi from 1.6.6 to 2.0.1 #186. Thanks to
> > Dependabot.
> > +
> > +
> > +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
> > @@ -946,3 +1070,5 @@ For complete information on Apache Commons
> > Configuration, including instructions
> >  patches, or suggestions for improvement, see the Apache Commons
> > Configuration website:
> >
> >  https://commons.apache.org/proper/commons-configuration/
> > +
> > +
> > diff --git a/src/changes/changes.xml b/src/changes/changes.xml
> > index 2c416023..70a00513 100644
> > --- a/src/changes/changes.xml
> > +++ b/src/changes/changes.xml
> > @@ -21,7 +21,7 @@
> >      <author email="dev@commons.apache.org">Apache Commons
> > Community</author>
> >    </properties>
> >    <body>
> > -    <release version="2.8.0" date="2020-MM-DD"
> > +    <release version="2.8.0" date="2022-06-25"
> >               description="Minor release with new features and updated
> > dependencies.">
> >         <!-- FIX -->
> >         <action issue="CONFIGURATION-753" type="fix" dev="mattjuntunen">
> > diff --git a/src/site/xdoc/building.xml b/src/site/xdoc/building.xml
> > index e07e6e82..96852dd2 100644
> > --- a/src/site/xdoc/building.xml
> > +++ b/src/site/xdoc/building.xml
> > @@ -34,13 +34,11 @@
> >              "mvn install". This will compile the source and tests, run
> > the tests, and then
> >              package the jar. The jar will also be copied into the local
> > maven repository
> >              for use by other builds. According to the minimum Java
> > version of
> > -            Commons Configuration, this build requires a JDK 1.6 or
> > higher.
> > +            Commons Configuration, this build requires a JDK 8 or higher.
> >            </p>
> >            <p>
> >              To build the web site run "mvn site". When it completes the
> > web site will reside in
> >              the target/site directory and may be viewed by opening
> > target/site/index.html.
> > -            Note that due to a dependency to a maven reporting plugin,
> > the build of the site
> > -            requires JDK 1.7 or higher.
> >            </p>
> >          </section>
> >      </body>
> > diff --git a/src/site/xdoc/download_configuration.xml
> > b/src/site/xdoc/download_configuration.xml
> > index 177b4402..b4461122 100644
> > --- a/src/site/xdoc/download_configuration.xml
> > +++ b/src/site/xdoc/download_configuration.xml
> > @@ -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.0 (reworked 2.x
> > version)">
> >        <subsection name="Binaries">
> >          <table>
> >            <tr>
> > -              <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.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.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.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>
> > @@ -148,12 +148,12 @@ limitations under the License.
> >          <table>
> >            <tr>
> >                <td><a
> > href="[preferred]/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz">commons-configuration-1.10-bin.tar.gz</a></td>
> > -              <td><a href="
> > https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.sha256
> > ">sha256</a></td>
> > +              <td><a href="
> > https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.sha512
> > ">sha512</a></td>
> >                <td><a href="
> > https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.tar.gz.asc
> > ">pgp</a></td>
> >            </tr>
> >            <tr>
> >                <td><a
> > href="[preferred]/commons/configuration/binaries/commons-configuration-1.10-bin.zip">commons-configuration-1.10-bin.zip</a></td>
> > -              <td><a href="
> > https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.zip.sha256
> > ">sha256</a></td>
> > +              <td><a href="
> > https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.zip.sha512
> > ">sha512</a></td>
> >                <td><a href="
> > https://www.apache.org/dist/commons/configuration/binaries/commons-configuration-1.10-bin.zip.asc
> > ">pgp</a></td>
> >            </tr>
> >          </table>
> > @@ -162,12 +162,12 @@ limitations under the License.
> >          <table>
> >            <tr>
> >                <td><a
> > href="[preferred]/commons/configuration/source/commons-configuration-1.10-src.tar.gz">commons-configuration-1.10-src.tar.gz</a></td>
> > -              <td><a href="
> > https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.tar.gz.sha256
> > ">sha256</a></td>
> > +              <td><a href="
> > https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.tar.gz.sha512
> > ">sha512</a></td>
> >                <td><a href="
> > https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.tar.gz.asc
> > ">pgp</a></td>
> >            </tr>
> >            <tr>
> >                <td><a
> > href="[preferred]/commons/configuration/source/commons-configuration-1.10-src.zip">commons-configuration-1.10-src.zip</a></td>
> > -              <td><a href="
> > https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.zip.sha256
> > ">sha256</a></td>
> > +              <td><a href="
> > https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.zip.sha512
> > ">sha512</a></td>
> >                <td><a href="
> > https://www.apache.org/dist/commons/configuration/source/commons-configuration-1.10-src.zip.asc
> > ">pgp</a></td>
> >            </tr>
> >          </table>
> >
> >

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org