Added: dev/commons/release-plugin/1.8.3-RC1/site/development.html ============================================================================== --- dev/commons/release-plugin/1.8.3-RC1/site/development.html (added) +++ dev/commons/release-plugin/1.8.3-RC1/site/development.html Sun Nov 3 20:07:40 2024 @@ -0,0 +1,375 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 03 November 2024 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="ISO-8859-1" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="Apache Commons Documentation Team" /> + <meta name="Date-Revision-yyyymmdd" content="20241103" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Commons Release Plugin – Development</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + + </head> + + <body class="composite"> + <a href="https://commons.apache.org/"; id="bannerLeft" title="Apache Commons logo"> + <img class="logo-left" src=" ./images/commons-logo.png +" alt="Apache Commons logo"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commons.apache.org/proper/commons-release-plugin/";>Apache Commons Release Plugin ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 03 November 2024</li> + <li class="divider">|</li> <li id="projectVersion">Version: 1.8.3</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="https://www.apachecon.com/"; class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="https://www.apache.org"; class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="../../" title="Commons"> + Commons</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Release Plugin</li> + <li class="none"> + <a href="index.html" title="Overview"> + Overview</a> + </li> + <li class="none"> + <a href="download_release-plugin.cgi" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="changes-report.html" title="Release History"> + Release History</a> + </li> + <li class="none"> + <a href="plugin-info.html" title="Plugin Documentation"> + Plugin Documentation</a> + </li> + <li class="none"> + <a href="javadocs/api-release/index.html" title="Javadoc (Latest release)"> + Javadoc (Latest release)</a> + </li> + <li class="expanded active"> + <a href="development.html" title="Help"> + Help</a> + <ul> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking"> + Issue Tracking</a> + </li> + <li class="none active"> + <a href="development.html" title="Development"> + Development</a> + </li> + </ul> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="collapsed"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="../../" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="https://www.apache.org/licenses/"; class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="../../components.html" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="../../sandbox/index.html" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="../../dormant/index.html" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="../../security.html" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="../../volunteering.html" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="../../patches.html" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="../../building.html" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="../../commons-parent-pom.html" title="Commons Parent POM"> + Commons Parent POM</a> + </li> + <li class="none"> + <a href="../../build-plugin/index.html" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="../../release-plugin/index.html" title="Commons Release Plugin"> + Commons Release Plugin</a> + </li> + <li class="none"> + <a href="../../site-publish.html" title="Site Publication"> + Site Publication</a> + </li> + <li class="none"> + <a href="../../releases/index.html" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage"; class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/getinvolved.html"; class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="https://www.apache.org/dev/"; class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/policies/conduct.html"; class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html"; class="externalLink" title="Privacy"> + Privacy</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="https://www.apache.org/events/current-event.html"; title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png"; /> + </a> + <a href="https://maven.apache.org/"; title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png"; /> + </a> + </div> + </td> + <td class="content"> + + + + + <section> +<h2><a name="Help_with_Maven_Mojos"></a>Help with Maven Mojos</h2> + + +<p> + The best sources of information are + <a class="externalLink" href="http://maven.apache.org/guides/plugin/guide-java-plugin-development.html";>Developing Java Plugins for Maven 3.x</a> + and <a class="externalLink" href="http://www.sonatype.com/book/chapter-11.html";>Maven: The Definitive Guide: Chapter 11 Writing Plugins</a>. + </p> + + </section> + + <section> +<h2><a name="New_Mojos"></a>New Mojos</h2> + + +<p> + Each Mojo is a java file that extends <code>AbstractMojo</code> that contains an annotation specifying + the goal name for the mojo and the maven lifecycle phase that it executes under by default. For, example +</p> +<div class="source"> +<pre> +package org.apache.commons.release.plugin.mojos; + +@Mojo(name = "detach-distributions", defaultPhase = LifecyclePhase.VERIFY, threadSafe = true) +public class CommonsDistributionDetachmentMojo extends AbstractMojo { + ..... +}</pre></div> + specifies the goal <code>commons-release:detach-distributions</code> that is to occur during the VERIFY maven + lifecycle. + + + +<p> + The variables in the mojo that are declared as private with the annotations <code>@Parameter</code> get + imported to the Mojo by the existent maven variables or the declared <code><configuration></code>. For + example, we have a boolean variable named <code>dryRun</code> declared as: +</p> +<div class="source"> +<pre> +@Parameter(property = "commons.release.dryRun", defaultValue = "false") +private Boolean dryRun; +</pre></div> + that can be configured by + +<div class="source"> +<pre> +<plugin> + <groupId>org.apache.commons</groupId> + <artifactId>commons-release-plugin</artifactId> + <version>1.8.0</version> + <configuration> + <dryRun>true</dryRun> + </configuration> +</plugin></pre></div> + + And, because we've set the <code>property here</code> (as in the 1.1 release), you can, on the command line, + use the following <code>-Dcommons.release.dryRun=true</code>. + + + </section> + + <section> +<h2><a name="Unit_testing"></a>Unit testing</h2> + + +<p> + We've declared mock maven poms in the <code>resources</code> directory of the <code>src/test</code> folder, + under which we've stored in subdirectories corresponding to the names of the mojos that they are testing. All + variables that you wish to be available to your mojo must be specifically declared in the mock pom file. For + example, we need to use the already existent <code>MavenProject</code> in the maven runtime by instead, in a + test package declaring a class extending <code>MavenProjectStub</code> that returns values we wish to be used + in testing. We then add this to our pom in the following declaration of the plugin: + </p> +<div class="source"> +<pre> +<plugin> + <groupId>org.apache.commons</groupId> + <artifactId>commons-release-plugin</artifactId> + <configuration> + <project implementation="org.apache.commons.release.plugin.stubs.DistributionDetachmentProjectStub" /> + <workingDirectory>target/commons-release-plugin</workingDirectory> + <distSvnStagingUrl>mockDistSvnStagingUrl</distSvnStagingUrl> + </configuration> +</plugin></pre></div> + Also note here we are declaring other values that we are using in the testing of the plugin. We then retrieve + our instantiated mojo by declaring a <code>MojoRule</code> in our test class, + +<div class="source"> +<pre> +@Rule +public MojoRule rule = new MojoRule() { + @Override + protected void before() throws Throwable { + } + + @Override + protected void after() { + } +};</pre></div> + and then retrieve the mojo by newing up a <code>File</code> pointed to the path of the mock pom, and then + making the following call: + +<div class="source"> +<pre> +mojo = (CommonsSiteCompressionMojo) rule.lookupMojo("compress-site", testPom); +</pre></div> + where we are trying to get the mojo with the <code>compress-site</code> goal. + + + </section> + + <section> +<h2><a name="Debugging"></a>Debugging</h2> + + +<p> + Maven ships with a debugger under the hood. It is suggested that you have a sandbox project in which you can + run the goals or the plugin configuration. Once you have that set up you can run something like + </p> +<div class="source"> +<pre> +mvnDebug commons-release:detach-distributions +</pre></div> + which exposes a remote debugger on port 8000 and halts the maven process until you attach a remote debugger + to that port. Once you have a remote debugger attached the maven process continues and stops at any + breakpoints that you have set up in your project. + + + </section> + + + + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2018-2024 + <a href="https://www.apache.org/";>The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache Commons Release Plugin, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html>
Added: dev/commons/release-plugin/1.8.3-RC1/site/distribution-management.html ============================================================================== --- dev/commons/release-plugin/1.8.3-RC1/site/distribution-management.html (added) +++ dev/commons/release-plugin/1.8.3-RC1/site/distribution-management.html Sun Nov 3 20:07:40 2024 @@ -0,0 +1,294 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 03 November 2024 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="ISO-8859-1" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="Date-Revision-yyyymmdd" content="20241103" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Commons Release Plugin – Project Distribution Management</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + + </head> + + <body class="composite"> + <a href="https://commons.apache.org/"; id="bannerLeft" title="Apache Commons logo"> + <img class="logo-left" src=" ./images/commons-logo.png +" alt="Apache Commons logo"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commons.apache.org/proper/commons-release-plugin/";>Apache Commons Release Plugin ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 03 November 2024</li> + <li class="divider">|</li> <li id="projectVersion">Version: 1.8.3</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="https://www.apachecon.com/"; class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="https://www.apache.org"; class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="../../" title="Commons"> + Commons</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Release Plugin</li> + <li class="none"> + <a href="index.html" title="Overview"> + Overview</a> + </li> + <li class="none"> + <a href="download_release-plugin.cgi" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="changes-report.html" title="Release History"> + Release History</a> + </li> + <li class="none"> + <a href="plugin-info.html" title="Plugin Documentation"> + Plugin Documentation</a> + </li> + <li class="none"> + <a href="javadocs/api-release/index.html" title="Javadoc (Latest release)"> + Javadoc (Latest release)</a> + </li> + <li class="expanded"> + <a href="development.html" title="Help"> + Help</a> + <ul> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking"> + Issue Tracking</a> + </li> + <li class="none"> + <a href="development.html" title="Development"> + Development</a> + </li> + </ul> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="expanded"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + <ul> + <li class="none"> + <a href="index.html" title="About"> + About</a> + </li> + <li class="none"> + <a href="summary.html" title="Summary"> + Summary</a> + </li> + <li class="none"> + <a href="team.html" title="Team"> + Team</a> + </li> + <li class="none"> + <a href="scm.html" title="Source Code Management"> + Source Code Management</a> + </li> + <li class="none"> + <a href="issue-management.html" title="Issue Management"> + Issue Management</a> + </li> + <li class="none"> + <a href="mailing-lists.html" title="Mailing Lists"> + Mailing Lists</a> + </li> + <li class="none"> + <a href="dependency-info.html" title="Maven Coordinates"> + Maven Coordinates</a> + </li> + <li class="none"> + <a href="dependency-management.html" title="Dependency Management"> + Dependency Management</a> + </li> + <li class="none"> + <a href="dependencies.html" title="Dependencies"> + Dependencies</a> + </li> + <li class="none"> + <a href="dependency-convergence.html" title="Dependency Convergence"> + Dependency Convergence</a> + </li> + <li class="none"> + <a href="ci-management.html" title="CI Management"> + CI Management</a> + </li> + <li class="none active"> + <a href="distribution-management.html" title="Distribution Management"> + Distribution Management</a> + </li> + </ul> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="../../" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="https://www.apache.org/licenses/"; class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="../../components.html" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="../../sandbox/index.html" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="../../dormant/index.html" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="../../security.html" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="../../volunteering.html" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="../../patches.html" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="../../building.html" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="../../commons-parent-pom.html" title="Commons Parent POM"> + Commons Parent POM</a> + </li> + <li class="none"> + <a href="../../build-plugin/index.html" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="../../release-plugin/index.html" title="Commons Release Plugin"> + Commons Release Plugin</a> + </li> + <li class="none"> + <a href="../../site-publish.html" title="Site Publication"> + Site Publication</a> + </li> + <li class="none"> + <a href="../../releases/index.html" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage"; class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/getinvolved.html"; class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="https://www.apache.org/dev/"; class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/policies/conduct.html"; class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html"; class="externalLink" title="Privacy"> + Privacy</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="https://www.apache.org/events/current-event.html"; title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png"; /> + </a> + <a href="https://maven.apache.org/"; title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png"; /> + </a> + </div> + </td> + <td class="content"> + <section> +<h2><a name="Overview"></a>Overview</h2><a name="Overview"></a> +<p>The following is the distribution management information used by this project.</p><section> +<h3><a name="Repository_-_apache.releases.https"></a>Repository - apache.releases.https</h3><a name="Repository_-_apache.releases.https"></a><a class="externalLink" href="https://repository.apache.org/service/local/staging/deploy/maven2";>https://repository.apache.org/service/local/staging/deploy/maven2</a></section><section> +<h3><a name="Snapshot_Repository_-_apache.snapshots.https"></a>Snapshot Repository - apache.snapshots.https</h3><a name="Snapshot_Repository_-_apache.snapshots.https"></a><a class="externalLink" href="https://repository.apache.org/content/repositories/snapshots";>https://repository.apache.org/content/repositories/snapshots</a></section><section> +<h3><a name="Site_-_commons.site"></a>Site - commons.site</h3><a name="Site_-_commons.site"></a> +<p>scm:svn:https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-release-plugin</p></section></section> + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2018-2024 + <a href="https://www.apache.org/";>The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache Commons Release Plugin, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html> Added: dev/commons/release-plugin/1.8.3-RC1/site/download_commons-release-plugin.cgi ============================================================================== --- dev/commons/release-plugin/1.8.3-RC1/site/download_commons-release-plugin.cgi (added) +++ dev/commons/release-plugin/1.8.3-RC1/site/download_commons-release-plugin.cgi Sun Nov 3 20:07:40 2024 @@ -0,0 +1,4 @@ +#!/bin/sh +# Just call the standard mirrors.cgi script. It will use download.html +# as the input template. +exec /www/www.apache.org/dyn/mirrors/mirrors.cgi $* \ No newline at end of file Propchange: dev/commons/release-plugin/1.8.3-RC1/site/download_commons-release-plugin.cgi ------------------------------------------------------------------------------ svn:executable = * Added: dev/commons/release-plugin/1.8.3-RC1/site/download_release-plugin.html ============================================================================== --- dev/commons/release-plugin/1.8.3-RC1/site/download_release-plugin.html (added) +++ dev/commons/release-plugin/1.8.3-RC1/site/download_release-plugin.html Sun Nov 3 20:07:40 2024 @@ -0,0 +1,365 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 03 November 2024 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="ISO-8859-1" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="Apache Commons Documentation Team" /> + <meta name="Date-Revision-yyyymmdd" content="20241103" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Commons Release Plugin – Download Apache Commons Release Plugin</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + + </head> + + <body class="composite"> + <a href="https://commons.apache.org/"; id="bannerLeft" title="Apache Commons logo"> + <img class="logo-left" src=" ./images/commons-logo.png +" alt="Apache Commons logo"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commons.apache.org/proper/commons-release-plugin/";>Apache Commons Release Plugin ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 03 November 2024</li> + <li class="divider">|</li> <li id="projectVersion">Version: 1.8.3</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="https://www.apachecon.com/"; class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="https://www.apache.org"; class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="../../" title="Commons"> + Commons</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Release Plugin</li> + <li class="none"> + <a href="index.html" title="Overview"> + Overview</a> + </li> + <li class="none"> + <a href="download_release-plugin.cgi" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="changes-report.html" title="Release History"> + Release History</a> + </li> + <li class="none"> + <a href="plugin-info.html" title="Plugin Documentation"> + Plugin Documentation</a> + </li> + <li class="none"> + <a href="javadocs/api-release/index.html" title="Javadoc (Latest release)"> + Javadoc (Latest release)</a> + </li> + <li class="expanded"> + <a href="development.html" title="Help"> + Help</a> + <ul> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking"> + Issue Tracking</a> + </li> + <li class="none"> + <a href="development.html" title="Development"> + Development</a> + </li> + </ul> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="collapsed"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="../../" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="https://www.apache.org/licenses/"; class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="../../components.html" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="../../sandbox/index.html" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="../../dormant/index.html" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="../../security.html" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="../../volunteering.html" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="../../patches.html" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="../../building.html" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="../../commons-parent-pom.html" title="Commons Parent POM"> + Commons Parent POM</a> + </li> + <li class="none"> + <a href="../../build-plugin/index.html" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="../../release-plugin/index.html" title="Commons Release Plugin"> + Commons Release Plugin</a> + </li> + <li class="none"> + <a href="../../site-publish.html" title="Site Publication"> + Site Publication</a> + </li> + <li class="none"> + <a href="../../releases/index.html" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage"; class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/getinvolved.html"; class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="https://www.apache.org/dev/"; class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/policies/conduct.html"; class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html"; class="externalLink" title="Privacy"> + Privacy</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="https://www.apache.org/events/current-event.html"; title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png"; /> + </a> + <a href="https://maven.apache.org/"; title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png"; /> + </a> + </div> + </td> + <td class="content"> + + + <section> +<h2><a name="Download_Apache_Commons_Release_Plugin"></a>Download Apache Commons Release Plugin</h2> + <section> +<h3><a name="Using_a_Mirror"></a>Using a Mirror</h3> + +<p> + We recommend you use a mirror to download our release + builds, but you <b>must</b> <a class="externalLink" 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 src="[logo]" align="right" border="0" alt="" /></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 class="externalLink" 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 class="externalLink" href="https://downloads.apache.org/commons/KEYS";>KEYS</a> + file contains the public PGP keys used by Apache Commons developers + to sign releases. + </p> + </section> + </section> + <section> +<h2><a name="Apache_Commons_Release_Plugin_1.8.3"></a>Apache Commons Release Plugin 1.8.3 </h2> + <section> +<h3><a name="Binaries"></a>Binaries</h3> + +<table border="0" class="bodyTable"> + +<tr class="a"> + +<td align="left"><a href="[preferred]/commons/release-plugin/binaries/commons-release-plugin-1.8.3-bin.tar.gz">commons-release-plugin-1.8.3-bin.tar.gz</a></td> + +<td><a class="externalLink" href="https://downloads.apache.org/commons/release-plugin/binaries/commons-release-plugin-1.8.3-bin.tar.gz.sha512";>sha512</a></td> + +<td><a class="externalLink" href="https://downloads.apache.org/commons/release-plugin/binaries/commons-release-plugin-1.8.3-bin.tar.gz.asc";>pgp</a></td> + </tr> + +<tr class="b"> + +<td align="left"><a href="[preferred]/commons/release-plugin/binaries/commons-release-plugin-1.8.3-bin.zip">commons-release-plugin-1.8.3-bin.zip</a></td> + +<td><a class="externalLink" href="https://downloads.apache.org/commons/release-plugin/binaries/commons-release-plugin-1.8.3-bin.zip.sha512";>sha512</a></td> + +<td><a class="externalLink" href="https://downloads.apache.org/commons/release-plugin/binaries/commons-release-plugin-1.8.3-bin.zip.asc";>pgp</a></td> + </tr> + </table> + </section> + <section> +<h3><a name="Source"></a>Source</h3> + +<table border="0" class="bodyTable"> + +<tr class="a"> + +<td align="left"><a href="[preferred]/commons/release-plugin/source/commons-release-plugin-1.8.3-src.tar.gz">commons-release-plugin-1.8.3-src.tar.gz</a></td> + +<td><a class="externalLink" href="https://downloads.apache.org/commons/release-plugin/source/commons-release-plugin-1.8.3-src.tar.gz.sha512";>sha512</a></td> + +<td><a class="externalLink" href="https://downloads.apache.org/commons/release-plugin/source/commons-release-plugin-1.8.3-src.tar.gz.asc";>pgp</a></td> + </tr> + +<tr class="b"> + +<td align="left"><a href="[preferred]/commons/release-plugin/source/commons-release-plugin-1.8.3-src.zip">commons-release-plugin-1.8.3-src.zip</a></td> + +<td><a class="externalLink" href="https://downloads.apache.org/commons/release-plugin/source/commons-release-plugin-1.8.3-src.zip.sha512";>sha512</a></td> + +<td><a class="externalLink" href="https://downloads.apache.org/commons/release-plugin/source/commons-release-plugin-1.8.3-src.zip.asc";>pgp</a></td> + </tr> + </table> + </section> + </section> + <section> +<h2><a name="Archives"></a>Archives</h2> + +<p> + Older releases can be obtained from the archives. + </p> + +<ul> + +<li class="download"><a href="[preferred]/commons/release-plugin/">browse download area</a></li> + +<li><a class="externalLink" href="https://archive.apache.org/dist/commons/release-plugin/";>archives...</a></li> + </ul> + </section> + + + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2018-2024 + <a href="https://www.apache.org/";>The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache Commons Release Plugin, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html> Added: dev/commons/release-plugin/1.8.3-RC1/site/images/add.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/add.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/close.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/close.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/collapsed.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/collapsed.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/commons-logo.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/commons-logo.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/expanded.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/expanded.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/external-classic.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/external-classic.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/fix.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/fix.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/help_logo.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/help_logo.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_arrowfolderclosed1_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_arrowfolderclosed1_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_arrowfolderopen2_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_arrowfolderopen2_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_arrowwaste1_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_arrowwaste1_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_arrowwaste2_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_arrowwaste2_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_doc_lrg.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_doc_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_doc_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_doc_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_error_lrg.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_error_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_error_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_error_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_folder_lrg.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_folder_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_folder_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_folder_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_help_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_help_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_info_lrg.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_info_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_info_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_info_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_members_lrg.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_members_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_sortdown.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_sortdown.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_sortup.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_sortup.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_success_lrg.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_success_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_success_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_success_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_usergroups_lrg.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_usergroups_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_warning_lrg.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_warning_lrg.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_warning_sml.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/icon_warning_sml.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/logos/build-by-maven-black.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/logos/build-by-maven-black.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/logos/build-by-maven-white.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/logos/build-by-maven-white.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/logos/maven-feather.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/logos/maven-feather.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/newwindow-classic.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/newwindow-classic.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/nw_maj_rond.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/nw_maj_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/remove.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/remove.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/rss.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/rss.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/strich.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/strich.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/sw_maj_rond.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/sw_maj_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/sw_med_rond.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/sw_med_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/images/update.gif ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/images/update.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/img/glyphicons-halflings-white.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/img/glyphicons-halflings-white.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/img/glyphicons-halflings.png ============================================================================== Binary file - no diff available. Propchange: dev/commons/release-plugin/1.8.3-RC1/site/img/glyphicons-halflings.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: dev/commons/release-plugin/1.8.3-RC1/site/index.html ============================================================================== --- dev/commons/release-plugin/1.8.3-RC1/site/index.html (added) +++ dev/commons/release-plugin/1.8.3-RC1/site/index.html Sun Nov 3 20:07:40 2024 @@ -0,0 +1,475 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia at 03 November 2024 + | Rendered using Apache Maven Fluido Skin 1.3.0 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="ISO-8859-1" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="Apache Commons Team" /> + <meta name="Date-Revision-yyyymmdd" content="20241103" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Commons Release Plugin – Overview</title> + + <link rel="stylesheet" href="./css/bootstrap.min.css" type="text/css" /> + <link rel="stylesheet" href="./css/site.css" type="text/css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + + <script type="text/javascript" src="./js/jquery.min.js"></script> + <script type="text/javascript" src="./js/bootstrap.min.js"></script> + <script type="text/javascript" src="./js/prettify.min.js"></script> + <script type="text/javascript" src="./js/site.js"></script> + + + </head> + + <body class="composite"> + <a href="https://commons.apache.org/"; id="bannerLeft" title="Apache Commons logo"> + <img class="logo-left" src=" ./images/commons-logo.png +" alt="Apache Commons logo"/> + </a> + <div class="clear"></div> + + <div class="navbar"> + <div class="navbar-inner"> + <div class="container-fluid"> + <a class="brand" href="https://commons.apache.org/proper/commons-release-plugin/";>Apache Commons Release Plugin ™</a> + <ul class="nav"> + + <li id="publishDate">Last Published: 03 November 2024</li> + <li class="divider">|</li> <li id="projectVersion">Version: 1.8.3</li> + </ul> + <div class="pull-right"> <ul class="nav"> + <li> + <a href="https://www.apachecon.com/"; class="externalLink" title="ApacheCon"> + ApacheCon</a> + </li> + <li> + <a href="https://www.apache.org"; class="externalLink" title="Apache"> + Apache</a> + </li> + <li> + <a href="../../" title="Commons"> + Commons</a> + </li> + </ul> +</div> + </div> + </div> + </div> + + <div class="container-fluid"> + <table class="layout-table"> + <tr> + <td class="sidebar"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Release Plugin</li> + <li class="none active"> + <a href="index.html" title="Overview"> + Overview</a> + </li> + <li class="none"> + <a href="download_release-plugin.cgi" title="Download"> + Download</a> + </li> + <li class="none"> + <a href="changes-report.html" title="Release History"> + Release History</a> + </li> + <li class="none"> + <a href="plugin-info.html" title="Plugin Documentation"> + Plugin Documentation</a> + </li> + <li class="none"> + <a href="javadocs/api-release/index.html" title="Javadoc (Latest release)"> + Javadoc (Latest release)</a> + </li> + <li class="expanded"> + <a href="development.html" title="Help"> + Help</a> + <ul> + <li class="none"> + <a href="issue-tracking.html" title="Issue Tracking"> + Issue Tracking</a> + </li> + <li class="none"> + <a href="development.html" title="Development"> + Development</a> + </li> + </ul> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header"><i class="icon-info-sign"></i>Project Documentation</li> + <li class="expanded"> + <a href="project-info.html" title="Project Information"> + Project Information</a> + <ul> + <li class="none active"> + <a href="index.html" title="About"> + About</a> + </li> + <li class="none"> + <a href="summary.html" title="Summary"> + Summary</a> + </li> + <li class="none"> + <a href="team.html" title="Team"> + Team</a> + </li> + <li class="none"> + <a href="scm.html" title="Source Code Management"> + Source Code Management</a> + </li> + <li class="none"> + <a href="issue-management.html" title="Issue Management"> + Issue Management</a> + </li> + <li class="none"> + <a href="mailing-lists.html" title="Mailing Lists"> + Mailing Lists</a> + </li> + <li class="none"> + <a href="dependency-info.html" title="Maven Coordinates"> + Maven Coordinates</a> + </li> + <li class="none"> + <a href="dependency-management.html" title="Dependency Management"> + Dependency Management</a> + </li> + <li class="none"> + <a href="dependencies.html" title="Dependencies"> + Dependencies</a> + </li> + <li class="none"> + <a href="dependency-convergence.html" title="Dependency Convergence"> + Dependency Convergence</a> + </li> + <li class="none"> + <a href="ci-management.html" title="CI Management"> + CI Management</a> + </li> + <li class="none"> + <a href="distribution-management.html" title="Distribution Management"> + Distribution Management</a> + </li> + </ul> + </li> + <li class="collapsed"> + <a href="project-reports.html" title="Project Reports"> + Project Reports</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">Commons</li> + <li class="none"> + <a href="../../" title="Home"> + Home</a> + </li> + <li class="none"> + <a href="https://www.apache.org/licenses/"; class="externalLink" title="License"> + License</a> + </li> + <li class="collapsed"> + <a href="../../components.html" title="Components"> + Components</a> + </li> + <li class="collapsed"> + <a href="../../sandbox/index.html" title="Sandbox"> + Sandbox</a> + </li> + <li class="collapsed"> + <a href="../../dormant/index.html" title="Dormant"> + Dormant</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">General Information</li> + <li class="none"> + <a href="../../security.html" title="Security"> + Security</a> + </li> + <li class="none"> + <a href="../../volunteering.html" title="Volunteering"> + Volunteering</a> + </li> + <li class="none"> + <a href="../../patches.html" title="Contributing Patches"> + Contributing Patches</a> + </li> + <li class="none"> + <a href="../../building.html" title="Building Components"> + Building Components</a> + </li> + <li class="none"> + <a href="../../commons-parent-pom.html" title="Commons Parent POM"> + Commons Parent POM</a> + </li> + <li class="none"> + <a href="../../build-plugin/index.html" title="Commons Build Plugin"> + Commons Build Plugin</a> + </li> + <li class="none"> + <a href="../../release-plugin/index.html" title="Commons Release Plugin"> + Commons Release Plugin</a> + </li> + <li class="none"> + <a href="../../site-publish.html" title="Site Publication"> + Site Publication</a> + </li> + <li class="none"> + <a href="../../releases/index.html" title="Releasing Components"> + Releasing Components</a> + </li> + <li class="none"> + <a href="https://cwiki.apache.org/confluence/display/commons/FrontPage"; class="externalLink" title="Wiki"> + Wiki</a> + </li> + </ul> + <ul class="nav nav-list"> + <li class="nav-header">ASF</li> + <li class="none"> + <a href="https://www.apache.org/foundation/how-it-works.html"; class="externalLink" title="How the ASF works"> + How the ASF works</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/getinvolved.html"; class="externalLink" title="Get Involved"> + Get Involved</a> + </li> + <li class="none"> + <a href="https://www.apache.org/dev/"; class="externalLink" title="Developer Resources"> + Developer Resources</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/policies/conduct.html"; class="externalLink" title="Code of Conduct"> + Code of Conduct</a> + </li> + <li class="none"> + <a href="https://privacy.apache.org/policies/privacy-policy-public.html"; class="externalLink" title="Privacy"> + Privacy</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/sponsorship.html"; class="externalLink" title="Sponsorship"> + Sponsorship</a> + </li> + <li class="none"> + <a href="https://www.apache.org/foundation/thanks.html"; class="externalLink" title="Thanks"> + Thanks</a> + </li> + </ul> + </div> + <div id="poweredBy"> + <a href="https://www.apache.org/events/current-event.html"; title="ApacheCon" class="builtBy"> + <img class="builtBy" alt="ApacheCon" src="https://www.apache.org/events/current-event-125x125.png"; /> + </a> + <a href="https://maven.apache.org/"; title="Maven" class="builtBy"> + <img class="builtBy" alt="Maven" src="https://maven.apache.org/images/logos/maven-feather.png"; /> + </a> + </div> + </td> + <td class="content"> + + + + + <section> +<h2><a name="Release_Plugin"></a>Release Plugin</h2> + + +<p> + This is a <a class="externalLink" href="http://maven.apache.org/";>Maven 3.x</a> Plugin which is + used by <a class="externalLink" href="https://commons.apache.org/";>Apache Commons</a> releases. See + the <a href="development.html">Development</a> page for information to + help maintain this plugin. + </p> + + +<p>The main purpose of the plugin is to automate the steps of our, namely + The Apache Commons Project's, release process. Currently we have the mechanics + for detaching distribution artifacts (i.e. all <code>tar.gz</code> artifacts and + signatures as well as all <code>.zip</code> artifacts and signatures), creating + a <code>site.zip</code> file, and staging all of those artifacts in a subversion + repository (for the most part a subdirectory of + <a class="externalLink" href="https://dist.apache.org/repos/dist/dev/commons/";>https://dist.apache.org/repos/dist/dev/commons/</a>. + It can, however, stage to any subversion repository. + </p> + + </section> + + <section> +<h2><a name="Plugin_Goals"></a>Plugin Goals</h2> + +<p> + Available Goals (which are meant to be used together; the only reason they are separated is for + code readability): + </p> +<ul> + +<li> + <b>commons-release:detach-distributions</b> - Remove + <code>tar.gz</code>, <code>tar.gz.asc</code>, <code>zip</code>, and <code>zip.asc</code> + files from being uploaded to nexus and copy them to the <code>target/commons-release-plugin</code> + directory. + </li> + +<li> + <b>commons-release:stage-distributions</b> - Take all staged files in the + <code>target/commons-release-plugin</code> directory, and the <code>RELEASE-NOTES.txt</code> from + the root of the project, and commit them to a specified staging subversion repository. + </li> + +<li> + <a href="vote-txt.html">commons-release:vote-txt</a> -Dcommons.nexus.repo.id=nnnn [-Dgit.tag.name] # where nnn is the number following orgapachecommons- in the Nexus 'Repository' column + </li> + </ul> + + </section> + + <section> +<h2><a name="Using_the_plugin"></a>Using the plugin</h2> + +<p> + Configure the plugin as the last plugin in the<code><build></code> section of the <code>pom.xml</code> + </p> + +<p>N.B. This is now done in the Commons Parent POM, so is not needed in the component POM.</p> + +<div class="source"> +<pre> +<plugin> + <groupId>org.apache.commons</groupId> + <artifactId>commons-release-plugin</artifactId> + <version>1.8.0</version> + <executions> + <execution> + <id>clean-staging</id> + <phase>post-clean</phase> + <goals> + <goal>clean-staging</goal> + </goals> + </execution> + <execution> + <id>detach-distributions</id> + <phase>verify</phase> + <goals> + <goal>detach-distributions</goal> + </goals> + </execution> + <execution> + <id>stage-distributions</id> + <phase>deploy</phase> + <goals> + <goal>stage-distributions</goal> + </goals> + </execution> + </executions> +</plugin> +</pre></div> + +<p> + The following properties need to be defined in the component POM if not already defined + </p> + +<div class="source"> +<pre> + <properties> + <!-- Previous version of the component (used for reporting binary compatibility check)--> + <commons.bc.version>m.n</commons.bc.version> + <commons.release.isDistModule>true</commons.release.isDistModule> + </properties> +</pre></div> + +<p> + Ensure your Release Manager details are defined in your Maven <code>~/.m2/settings.xml</code> file + (These are used by the vote-txt goal) + Properties have to be defined in a profile. For example: + </p> + +<div class="source"> +<pre> +<settings> + ... + <profiles> + ... + <profile> + <id>active-profile</id> + <properties> + <commons.releaseManagerName>Your Name</commons.releaseManagerName> + <commons.releaseManagerKey>Your Signing Key Hex ID</commons.releaseManagerKey> + </properties> + </profile> + </profiles> + + <activeProfiles> + <!-- define active profile name --> + <activeProfile>active-profile</activeProfile> + </activeProfiles> + ... +</settings> +</pre></div> + +<p> + After the above configuration performing the release would occur by (<i>note.</i> more + in depth details can be found at + <a class="externalLink" href="https://commons.apache.org/releases/prepare.html";>Preparations For A Release</a>): + </p> +<ol style="list-style-type: decimal"> + +<li>creating our release branch,</li> + +<li>checking compatibility,</li> + +<li>checking your dependencies,</li> + +<li>checking javadocs and code style,</li> + +<li>checking the apache license,</li> + +<li>configure the build to generate a complete set of release artifacts,</li> + +<li>preparing the release notes, updating the download file and other autogenerated files,</li> + +<li>tagging the release candidate, and</li> + +<li> + running the following command: + +<div class="source"> +<pre> +mvn -Duser.name=<yourApacheId> [-Duser.password=<yourApacheIdsPassword] [-Dcommons.release.dryRun=true -Ptest-deploy] -Prelease clean test site deploy +</pre></div> + </li> + </ol> + To avoid specifying distribution credentials at the command + line, consider using the <code>distServer</code> plugin configuration parameter (property <code>commons.distServer</code>) + to specify a server definition in Maven <code>settings.xml</code> which defines your (encrypted, right?) authentication info. + + + +<p> + If the component is new, then, before running this maven command, you would want to create + the requisite subversion directory <code>https://dist.apache.org/repos/dist/dev/commons/foo</code>. Notice, + that the way to perform a dry run of the release you need to include + <code>-Dcommons.release.dryRun=true -Ptest-deploy</code>. + </p> + </section> + + + </td> + </tr> + </table> + </div> + + <div class="footer"> + <p>Copyright © 2018-2024 + <a href="https://www.apache.org/";>The Apache Software Foundation</a>. + All Rights Reserved.</p> + +<div class="center">Apache Commons, Apache Commons Release Plugin, Apache, the Apache feather logo, and the Apache Commons project logos are trademarks of The Apache Software Foundation. + All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div> + </div> + </body> + +</html>
![https://www.apache.org/events/current-event-125x125.png"](https://www.apache.org/events/current-event-125x125.png"){kind=link}
![https://maven.apache.org/images/logos/maven-feather.png"](https://maven.apache.org/images/logos/maven-feather.png"){kind=link}