1
0

Prepare for release candidate

This commit is contained in:
Gary Gregory
2023-11-26 16:24:49 -05:00
parent 115812fe62
commit 18ed8eb8ad
9 changed files with 251 additions and 119 deletions

View File

@@ -43,7 +43,7 @@ The <action> type attribute can be add,update,fix,remove.
<title>Release Notes</title>
</properties>
<body>
<release version="1.3.0" date="TBD" description="This is a maintenance release containing bug fixes. Java 8 or later is required.">
<release version="1.3.0" date="2023-11-26" description="This is a feature and maintenance release. Java 8 or later is required.">
<!-- ADD -->
<action dev="ggregory" type="add" due-to="Piotr P. Karwasz">
Add support for Log4j API and SLF4J #177.

View File

@@ -14,9 +14,9 @@
## KIND, either express or implied. See the License for the
## specific language governing permissions and limitations
## under the License.
${project.name}
Version ${version}
RELEASE NOTES
${project.name}
Version ${version}
RELEASE NOTES
The ${developmentTeam} is pleased to announce the release of ${project.name} ${version}
@@ -106,4 +106,6 @@ Historical list of changes: ${project.url}changes-report.html
For complete information on ${project.name}, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the ${project.name} website:
${project.url}
${project.url}
=============================================================================

View File

@@ -26,15 +26,28 @@ limitations under the License.
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
| 1) Re-generate using: mvn commons:download-page |
| 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.componentid (required, alphabetic, lower case) |
| - commons.release.version (required) |
| - commons.binary.suffix (optional) |
| - 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> |
@@ -46,17 +59,17 @@ limitations under the License.
<document>
<properties>
<title>Download Apache Commons Logging</title>
<author email="dev@commons.apache.org">Commons Documentation Team</author>
<author email="dev@commons.apache.org">Apache Commons Documentation Team</author>
</properties>
<body>
<section name="Download Apache Commons Logging">
<subsection name="Using a Mirror">
<p>
We recommend you use a mirror to download our release
builds, but you <strong>must</strong> verify the integrity of
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 the mirrors.
be available from all the mirrors.
</p>
<p>
@@ -88,39 +101,44 @@ limitations under the License.
</form>
<p>
The <a href="https//www.apache.org/dist/commons/KEYS">KEYS</a>
link links to the code signing keys used to sign the product.
The <code>PGP</code> link downloads the OpenPGP compatible signature from our main site.
The <code>MD5</code> link downloads the checksum from the main site.
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://downloads.apache.org/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 Logging 1.2 ">
<section name="Apache Commons Logging 1.3.0 ">
<subsection name="Binaries">
<table>
<tr>
<td><a href="[preferred]/commons/logging/binaries/commons-logging-1.2-bin.tar.gz">commons-logging-1.2-bin.tar.gz</a></td>
<td><a href="https//www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.tar.gz.md5">md5</a></td>
<td><a href="https//www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.tar.gz.asc">pgp</a></td>
<td><a href="[preferred]/commons/logging/binaries/commons-logging-1.3.0-bin.tar.gz">commons-logging-1.3.0-bin.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/logging/binaries/commons-logging-1.3.0-bin.tar.gz.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/logging/binaries/commons-logging-1.3.0-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
<td><a href="[preferred]/commons/logging/binaries/commons-logging-1.2-bin.zip">commons-logging-1.2-bin.zip</a></td>
<td><a href="https//www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.zip.md5">md5</a></td>
<td><a href="https//www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.zip.asc">pgp</a></td>
<td><a href="[preferred]/commons/logging/binaries/commons-logging-1.3.0-bin.zip">commons-logging-1.3.0-bin.zip</a></td>
<td><a href="https://downloads.apache.org/commons/logging/binaries/commons-logging-1.3.0-bin.zip.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/logging/binaries/commons-logging-1.3.0-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
<td><a href="[preferred]/commons/logging/source/commons-logging-1.2-src.tar.gz">commons-logging-1.2-src.tar.gz</a></td>
<td><a href="https//www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.tar.gz.md5">md5</a></td>
<td><a href="https//www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.tar.gz.asc">pgp</a></td>
<td><a href="[preferred]/commons/logging/source/commons-logging-1.3.0-src.tar.gz">commons-logging-1.3.0-src.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/logging/source/commons-logging-1.3.0-src.tar.gz.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/logging/source/commons-logging-1.3.0-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
<td><a href="[preferred]/commons/logging/source/commons-logging-1.2-src.zip">commons-logging-1.2-src.zip</a></td>
<td><a href="https//www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.zip.md5">md5</a></td>
<td><a href="https//www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.zip.asc">pgp</a></td>
<td><a href="[preferred]/commons/logging/source/commons-logging-1.3.0-src.zip">commons-logging-1.3.0-src.zip</a></td>
<td><a href="https://downloads.apache.org/commons/logging/source/commons-logging-1.3.0-src.zip.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/logging/source/commons-logging-1.3.0-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
@@ -131,7 +149,7 @@ limitations under the License.
</p>
<ul>
<li class="download"><a href="[preferred]/commons/logging/">browse download area</a></li>
<li><a href="https//archive.apache.org/dist/commons/logging/">archives...</a></li>
<li><a href="https://archive.apache.org/dist/commons/logging/">archives...</a></li>
</ul>
</section>
</body>

View File

@@ -26,7 +26,7 @@ limitations under the License.
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
| 1) Re-generate using: mvn commons:jira-page |
| 1) Re-generate using: mvn commons-build:jira-page |
| |
| 2) Set the following properties in the component's pom: |
| - commons.jira.id (required, alphabetic, upper case) |
@@ -43,35 +43,35 @@ limitations under the License.
-->
<document>
<properties>
<title>Commons Logging Issue tracking</title>
<author email="dev@commons.apache.org">Commons Documentation Team</author>
<title>Apache Commons Logging Issue tracking</title>
<author email="dev@commons.apache.org">Apache Commons Documentation Team</author>
</properties>
<body>
<section name="Commons Logging Issue tracking">
<section name="Apache Commons Logging Issue tracking">
<p>
Commons Logging uses <a href="https//issues.apache.org/jira/">ASF JIRA</a> for tracking issues.
See the <a href="https//issues.apache.org/jira/browse/LOGGING">Commons Logging JIRA project page</a>.
Apache Commons Logging uses <a href="https://issues.apache.org/jira/">ASF JIRA</a> for tracking issues.
See the <a href="https://issues.apache.org/jira/browse/LOGGING">Apache Commons Logging JIRA project page</a>.
</p>
<p>
To use JIRA you may need to <a href="https//issues.apache.org/jira/secure/Signup!default.jspa">create an account</a>
To use JIRA you may need to <a href="https://issues.apache.org/jira/secure/Signup!default.jspa">create an account</a>
(if you have previously created/updated Commons issues using Bugzilla an account will have been automatically
created and you can use the <a href="https//issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a>
created and you can use the <a href="https://issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a>
page to get a new password).
</p>
<p>
If you would like to report a bug, or raise an enhancement request with
Commons Logging please do the following:
Apache Commons Logging please do the following:
<ol>
<li><a href="https//issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">Search existing open bugs</a>.
<li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">Search existing open bugs</a>.
If you find your issue listed then please add a comment with your details.</li>
<li><a href="mail-lists.html">Search the mailing list archive(s)</a>.
You may find your issue or idea has already been discussed.</li>
<li>Decide if your issue is a bug or an enhancement.</li>
<li>Submit either a <a href="https//issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310484&amp;issuetype=1&amp;priority=4&amp;assignee=-1">bug report</a>
or <a href="https//issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310484&amp;issuetype=4&amp;priority=4&amp;assignee=-1">enhancement request</a>.</li>
<li>Submit either a <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310484&amp;issuetype=1&amp;priority=4&amp;assignee=-1">bug report</a>
or <a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310484&amp;issuetype=4&amp;priority=4&amp;assignee=-1">enhancement request</a>.</li>
</ol>
</p>
@@ -80,21 +80,21 @@ limitations under the License.
<ul>
<li>the more information you provide, the better we can help you</li>
<li>test cases are vital, particularly for any proposed enhancements</li>
<li>the developers of Commons Logging are all unpaid volunteers</li>
<li>the developers of Apache Commons Logging are all unpaid volunteers</li>
</ul>
</p>
<p>
For more information on subversion and creating patches see the
<a href="https//www.apache.org/dev/contributors.html">Apache Contributors Guide</a>.
For more information on creating patches see the
<a href="https://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>.
</p>
<p>
You may also find these links useful:
<ul>
<li><a href="https//issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">All Open Commons Logging bugs</a></li>
<li><a href="https//issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=5&amp;status=6">All Resolved Commons Logging bugs</a></li>
<li><a href="https//issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC">All Commons Logging bugs</a></li>
<li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">All Open Apache Commons Logging bugs</a></li>
<li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=5&amp;status=6">All Resolved Apache Commons Logging bugs</a></li>
<li><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC">All Apache Commons Logging bugs</a></li>
</ul>
</p>
</section>

View File

@@ -26,7 +26,7 @@ limitations under the License.
| commons-build-plugin/trunk/src/main/resources/commons-xdoc-templates |
+======================================================================+
| |
| 1) Re-generate using: mvn commons:mail-page |
| 1) Re-generate using: mvn commons-build:mail-page |
| |
| 2) Set the following properties in the component's pom: |
| - commons.componentid (required, alphabetic, lower case) |
@@ -41,15 +41,15 @@ limitations under the License.
-->
<document>
<properties>
<title>Commons Logging Mailing Lists</title>
<author email="dev@commons.apache.org">Commons Documentation Team</author>
<title>Apache Commons Logging Mailing Lists</title>
<author email="dev@commons.apache.org">Apache Commons Documentation Team</author>
</properties>
<body>
<section name="Overview">
<p>
<a href="index.html">Commons Logging</a> shares mailing lists with all the other
<a href="https//commons.apache.org/components.html">Commons Components</a>.
<a href="index.html">Apache Commons Logging</a> shares mailing lists with all the other
<a href="https://commons.apache.org/components.html">Commons Components</a>.
To make it easier for people to only read messages related to components they are interested in,
the convention in Commons is to prefix the subject line of messages with the component's name,
for example:
@@ -58,24 +58,29 @@ limitations under the License.
</ul>
</p>
<p>
Questions related to the usage of Commons Logging should be posted to the
<a href="https//mail-archives.apache.org/mod_mbox/commons-user/">User List</a>.
Questions related to the usage of Apache Commons Logging should be posted to the
<a href="https://lists.apache.org/list.html?user@commons.apache.org">User List</a>.
<br />
The <a href="https//mail-archives.apache.org/mod_mbox/commons-dev/">Developer List</a>
is for questions and discussion related to the development of Commons Logging.
The <a href="https://lists.apache.org/list.html?dev@commons.apache.org">Developer List</a>
is for questions and discussion related to the development of Apache Commons Logging.
<br />
Please do not cross-post; developers are also subscribed to the user list.
<br />
You must be subscribed to post to the mailing lists. Follow the Subscribe links below
to subscribe.
</p>
<p>
<strong>Note:</strong> please don't send patches or attachments to any of the mailing lists.
Patches are best handled via the <a href="issue-tracking.html">Issue Tracking</a> system.
Otherwise, please upload the file to a public server and include the URL in the mail.
<strong>Note:</strong> please don't send patches or attachments to any of the mailing lists;
most of the lists are set up to drop attachments.
Patches are best handled via the <a href="issue-tracking.html">Issue Tracking</a> system.
If you have a GitHub account, most components also accept PRs (pull requests).
Otherwise, please upload the file to a public server and include the URL in the mail.
</p>
</section>
<section name="Commons Logging Mailing Lists">
<section name="Apache Commons Logging Mailing Lists">
<p>
<strong>Please prefix the subject line of any messages for <a href="index.html">Commons Logging</a>
<strong>Please prefix the subject line of any messages for <a href="index.html">Apache Commons Logging</a>
with <i>[logging]</i></strong> - <i>thanks!</i>
<br />
<br />
@@ -96,16 +101,17 @@ limitations under the License.
<td>
<strong>Commons User List</strong>
<br /><br />
Questions on using Commons Logging.
Questions on using Apache Commons Logging.
<br /><br />
</td>
<td><a href="mailto:user-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:user-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><a href="mailto:user@commons.apache.org?subject=[logging]">Post</a></td>
<td><a href="https//mail-archives.apache.org/mod_mbox/commons-user/">mail-archives.apache.org</a></td>
<td><a href="https//markmail.org/list/org.apache.commons.users/">markmail.org</a><br />
<a href="https//www.mail-archive.com/user@commons.apache.org/">www.mail-archive.com</a><br />
<a href="https//news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
<td>
<a href="https://lists.apache.org/list.html?user@commons.apache.org">lists.apache.org</a>
</td>
<td>
<a href="https://www.mail-archive.com/user@commons.apache.org/">www.mail-archive.com</a>
</td>
</tr>
@@ -114,16 +120,17 @@ limitations under the License.
<td>
<strong>Commons Developer List</strong>
<br /><br />
Discussion of development of Commons Logging.
Discussion of development of Apache Commons Logging.
<br /><br />
</td>
<td><a href="mailto:dev-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:dev-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><a href="mailto:dev@commons.apache.org?subject=[logging]">Post</a></td>
<td><a href="https//mail-archives.apache.org/mod_mbox/commons-dev/">mail-archives.apache.org</a></td>
<td><a href="https//markmail.org/list/org.apache.commons.dev/">markmail.org</a><br />
<a href="https//www.mail-archive.com/dev@commons.apache.org/">www.mail-archive.com</a><br />
<a href="https//news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
<td>
<a href="https://lists.apache.org/list.html?dev@commons.apache.org">lists.apache.org</a>
</td>
<td>
<a href="https://www.mail-archive.com/dev@commons.apache.org/">www.mail-archive.com</a>
</td>
</tr>
@@ -138,9 +145,11 @@ limitations under the License.
<td><a href="mailto:issues-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:issues-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><i>read only</i></td>
<td><a href="https//mail-archives.apache.org/mod_mbox/commons-issues/">mail-archives.apache.org</a></td>
<td><a href="https//markmail.org/list/org.apache.commons.issues/">markmail.org</a><br />
<a href="https//www.mail-archive.com/issues@commons.apache.org/">www.mail-archive.com</a>
<td>
<a href="https://lists.apache.org/list.html?issues@commons.apache.org">lists.apache.org</a>
</td>
<td>
<a href="https://www.mail-archive.com/issues@commons.apache.org/">www.mail-archive.com</a>
</td>
</tr>
@@ -149,15 +158,17 @@ limitations under the License.
<td>
<strong>Commons Commits List</strong>
<br /><br />
Only for e-mails automatically generated by the <a href="source-repository.html">source control</a> sytem.
Only for e-mails automatically generated by the <a href="scm.html">source control</a> system.
<br /><br />
</td>
<td><a href="mailto:commits-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:commits-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><i>read only</i></td>
<td><a href="https//mail-archives.apache.org/mod_mbox/commons-commits/">mail-archives.apache.org</a></td>
<td><a href="https//markmail.org/list/org.apache.commons.commits/">markmail.org</a><br />
<a href="https//www.mail-archive.com/commits@commons.apache.org/">www.mail-archive.com</a>
<td>
<a href="https://lists.apache.org/list.html?commits@commons.apache.org">lists.apache.org</a>
</td>
<td>
<a href="https://www.mail-archive.com/commits@commons.apache.org/">www.mail-archive.com</a>
</td>
</tr>
@@ -185,14 +196,14 @@ limitations under the License.
General announcements of Apache project releases.
<br /><br />
</td>
<td><a class="externalLink" href="mailto:announce-subscribe@apache.org">Subscribe</a></td>
<td><a class="externalLink" href="mailto:announce-unsubscribe@apache.org">Unsubscribe</a></td>
<td><a class="externalLink" href="mailto:announce-subscribe@apache.org">Subscribe</a></td>
<td><a class="externalLink" href="mailto:announce-unsubscribe@apache.org">Unsubscribe</a></td>
<td><i>read only</i></td>
<td><a class="externalLink" href="https//mail-archives.apache.org/mod_mbox/www-announce/">mail-archives.apache.org</a></td>
<td><a class="externalLink" href="https//markmail.org/list/org.apache.announce/">markmail.org</a><br />
<a class="externalLink" href="https//old.nabble.com/Apache-News-and-Announce-f109.html">old.nabble.com</a><br />
<a class="externalLink" href="https//www.mail-archive.com/announce@apache.org/">www.mail-archive.com</a><br />
<a class="externalLink" href="https//news.gmane.org/gmane.comp.apache.announce">news.gmane.org</a>
<td>
<a class="externalLink" href="https://lists.apache.org/list.html?announce@apache.org">lists.apache.org</a>
</td>
<td>
<a class="externalLink" href="https://www.mail-archive.com/announce@apache.org/">www.mail-archive.com</a>
</td>
</tr>
</table>