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/20 03:13:29 UTC

[commons-configuration] branch 2.8.0-release updated (4f9a451f -> 64345072)

This is an automated email from the ASF dual-hosted git repository.

mattjuntunen pushed a change to branch 2.8.0-release
in repository https://gitbox.apache.org/repos/asf/commons-configuration.git


    from 4f9a451f Use charset predefined StandardCharsets.UTF_8 code.
     new 07e0637b updating version and release manager info
     new 64345072 updating release docs

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 RELEASE-NOTES.txt                        | 126 +++++++++++++++
 pom.xml                                  |   6 +-
 src/changes/changes.xml                  |   2 +-
 src/site/xdoc/building.xml               |   4 +-
 src/site/xdoc/download_configuration.xml | 264 +++++++++++++++----------------
 5 files changed, 263 insertions(+), 139 deletions(-)


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


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

Posted by Gary Gregory <ga...@gmail.com>.
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>
>
>

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

Posted by ma...@apache.org.
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>


[commons-configuration] 01/02: updating version and release manager info

Posted by ma...@apache.org.
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 07e0637ba9c3264e53f76cb2dcfd320ca1085415
Author: Matt Juntunen <ma...@apache.org>
AuthorDate: Sun Jun 19 22:37:54 2022 -0400

    updating version and release manager info
---
 pom.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pom.xml b/pom.xml
index c5166324..f37be7bd 100644
--- a/pom.xml
+++ b/pom.xml
@@ -24,7 +24,7 @@
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>commons-configuration2</artifactId>
-  <version>2.8.0-SNAPSHOT</version>
+  <version>2.8.0</version>
   <name>Apache Commons Configuration</name>
 
   <inceptionYear>2001</inceptionYear>
@@ -610,8 +610,8 @@
     <commons.rc.version>RC1</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>