You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by hb...@apache.org on 2012/05/08 13:38:15 UTC
svn commit: r816531 [3/30] - in
/websites/production/maventest/content/plugins/maven-release-plugin-latest:
./ apidocs/ apidocs/org/apache/maven/plugins/release/
apidocs/org/apache/maven/plugins/release/class-use/ cobertura/ examples/
testapidocs/ test...
Modified: websites/production/maventest/content/plugins/maven-release-plugin-latest/branch-mojo.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-release-plugin-latest/branch-mojo.html (original)
+++ websites/production/maventest/content/plugins/maven-release-plugin-latest/branch-mojo.html Tue May 8 11:38:11 2012
@@ -12,7 +12,8 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <title>Maven Release plugin - release:branch</title>
+ <title>
+ release:branch</title>
<style type="text/css" media="all">
@import url("./css/maven-base.css");
@import url("./css/maven-theme.css");
@@ -28,16 +29,16 @@
</head>
<body class="composite">
<div id="banner">
- <a href="http://maven.apache.org/" id="bannerLeft">
+ <a href="../../" id="bannerLeft">
- <img src="http://maven.apache.org/images/apache-maven-project-2.png" alt="" />
+ <img src="../../images/apache-maven-project-2.png" alt="" />
</a>
- <a href="http://maven.apache.org/maven-release" id="bannerRight">
+ <span id="bannerRight">
- <img src="http://maven.apache.org/images/maven-logo-2.gif" alt="" />
+ <img src="../../images/maven-logo-2.gif" alt="" />
- </a>
+ </span>
<div class="clear">
<hr/>
</div>
@@ -56,13 +57,16 @@
<a href="http://www.apache.org/" class="externalLink">Apache</a>
>
- <a href="http://maven.apache.org/index.html" class="externalLink">Maven</a>
+ <a href="../../index.html">Maven</a>
+ >
+
+ <a href="../../maven-release/">Maven Release</a>
>
- <a href="http://maven.apache.org/plugins/index.html" class="externalLink">Plugins</a>
+ <a href="../index.html">Plugins</a>
>
- <a href="http://maven.apache.org/plugins/maven-release-plugin/index.html" class="externalLink">Maven Release Plugin</a>
+ <a href="index.html">Maven Release Plugin</a>
</div>
<div class="xright">
@@ -72,8 +76,8 @@
- Last Published: 2010-10-04
- | Version: 2.1
+ Last Published: 2011-06-27
+ | Version: 2.2
</div>
<div class="clear">
<hr/>
@@ -93,65 +97,65 @@
<ul>
<li class="none">
- <a href="../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Introduction</a>
+ <a href="index.html">Introduction</a>
</li>
<li class="none">
- <a href="../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Goals</a>
+ <a href="plugin-info.html">Goals</a>
</li>
<li class="none">
- <a href="../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Usage</a>
+ <a href="usage.html">Usage</a>
</li>
<li class="none">
- <a href="../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">FAQ</a>
+ <a href="faq.html">FAQ</a>
</li>
</ul>
<h5>Examples</h5>
<ul>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Prepare a Release</a>
+ <a href="examples/prepare-release.html">Prepare a Release</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Perform a Release</a>
+ <a href="examples/perform-release.html">Perform a Release</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Rollback a Release</a>
+ <a href="examples/rollback-release.html">Rollback a Release</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Clean a Release</a>
+ <a href="examples/clean-release.html">Clean a Release</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Generate Release POMs</a>
+ <a href="examples/generate-release-poms.html">Generate Release POMs</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Lock Files During Release</a>
+ <a href="examples/lock-files.html">Lock Files During Release</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Run Additional Goals Before Commit</a>
+ <a href="examples/run-goals-before-commit.html">Run Additional Goals Before Commit</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Create a Branch</a>
+ <a href="examples/branch.html">Create a Branch</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Non-interactive Release</a>
+ <a href="examples/non-interactive-release.html">Non-interactive Release</a>
</li>
<li class="none">
- <a href="../../Users/brett/scm/maven/release/target/checkout/../../../../../people.apache.org/www/maven.apache.org/plugins/maven-release-plugin">Update POM Versions</a>
+ <a href="examples/update-versions.html">Update POM Versions</a>
</li>
</ul>
- <h5>Project Documentation</h5>
+ <h5>Project Documentation</h5>
<ul>
@@ -179,6 +183,8 @@
+
+
<li class="collapsed">
<a href="project-info.html">Project Information</a>
@@ -216,47 +222,47 @@
<ul>
<li class="none">
- <a href="http://maven.apache.org/ant-tasks/index.html" class="externalLink">Ant Tasks</a>
+ <a href="../../ant-tasks/index.html">Ant Tasks</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/doxia/index.html" class="externalLink">Doxia</a>
+ <a href="../../archetype/index.html">Archetype</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/jxr/index.html" class="externalLink">JXR</a>
+ <a href="../../doxia/index.html">Doxia</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/maven-1.x/index.html" class="externalLink">Maven 1.x</a>
+ <a href="../../jxr/index.html">JXR</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/index.html" class="externalLink">Maven 2</a>
+ <a href="../../maven-1.x/index.html">Maven 1.x</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/mercury/index.html" class="externalLink">Mercury</a>
+ <a href="../../index.html">Maven 2</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/plugins/index.html" class="externalLink">Plugins</a>
+ <a href="../index.html">Plugins</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/scm/index.html" class="externalLink">SCM</a>
+ <a href="../../scm/index.html">SCM</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/shared/index.html" class="externalLink">Shared Components</a>
+ <a href="../../shared/index.html">Shared Components</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/surefire/index.html" class="externalLink">Surefire</a>
+ <a href="../../surefire/index.html">Surefire</a>
</li>
<li class="none">
- <a href="http://maven.apache.org/wagon/index.html" class="externalLink">Wagon</a>
+ <a href="../../wagon/index.html">Wagon</a>
</li>
</ul>
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
@@ -274,514 +280,567 @@
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2><a name="release:branch"></a>release:branch</h2>
-<p><strong>Full name</strong>:</p>
-<p>org.apache.maven.plugins:maven-release-plugin:2.1:branch</p>
-<p><strong>Description</strong>:</p>
-<div>Branch a project in SCM, using the same steps as the
+
+
+ <div class="section"><h2>release:branch<a name="release:branch"></a></h2>
+ <p><b>Full name</b>:</p>
+ <p>org.apache.maven.plugins:maven-release-plugin:2.2:branch</p>
+ <p><b>Description</b>:</p>
+ <div>Branch a project in SCM, using the same steps as the
<tt>release:prepare</tt> goal, creating a branch instead of a tag.
-For more info see <a href="http://maven.apache.org/plugins/maven-release-plugin/examples/branch.html" class="externalLink">
-http://maven.apache.org/plugins/maven-release-plugin/examples/branch.html</a>.</div><p><strong>Attributes</strong>:</p>
-<ul><li>Requires a Maven 2.0 project to be executed.</li>
-<li>Executes as an aggregator plugin.</li>
-<li>Since version: <code>2.0-beta-6</code>.</li>
-</ul>
-<div class="section"><h3><a name="Required_Parameters"></a>Required Parameters</h3>
-<table class="bodyTable"><tr class="a"><th>Name</th>
-<th>Type</th>
-<th>Since</th>
-<th>Description</th>
-</tr>
-<tr class="b"><td><strong><a href="#branchName">branchName</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>The branch name to use.<br />
-</td>
-</tr>
-</table>
-</div>
-<div class="section"><h3><a name="Optional_Parameters"></a>Optional Parameters</h3>
-<table class="bodyTable"><tr class="a"><th>Name</th>
-<th>Type</th>
-<th>Since</th>
-<th>Description</th>
-</tr>
-<tr class="b"><td><strong><a href="#addSchema">addSchema</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Whether to add a schema to the POM if it was previously missing on
-release.<br />
-<strong>Default value is</strong>: <code>true</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#arguments">arguments</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Additional arguments to pass to the Maven executions, separated by
-spaces.<br />
-</td>
-</tr>
-<tr class="b"><td><strong><a href="#autoVersionSubmodules">autoVersionSubmodules</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Whether to automatically assign submodules the parent version. If
+For more info see <a class="externalLink" href="http://maven.apache.org/plugins/maven-release-plugin/examples/branch.html">
+http://maven.apache.org/plugins/maven-release-plugin/examples/branch.html</a>.</div>
+ <p><b>Attributes</b>:</p>
+ <ul>
+ <li>Requires a Maven 2.0 project to be executed.</li>
+ <li>Executes as an aggregator plugin.</li>
+ <li>Since version: <tt>2.0-beta-6</tt>.</li>
+ </ul>
+ <div class="section"><h3>Required Parameters<a name="Required_Parameters"></a></h3>
+ <table class="bodyTable" border="0" align="left">
+ <tr class="a">
+ <th>Name</th>
+ <th>Type</th>
+ <th>Since</th>
+ <th>Description</th>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#branchName">branchName</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>The branch name to use.<br /></td>
+ </tr>
+ </table>
+ </div>
+ <div class="section"><h3>Optional Parameters<a name="Optional_Parameters"></a></h3>
+ <table class="bodyTable" border="0" align="left">
+ <tr class="a">
+ <th>Name</th>
+ <th>Type</th>
+ <th>Since</th>
+ <th>Description</th>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#addSchema">addSchema</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Whether to add a schema to the POM if it was previously missing on
+release.<br /><b>Default value is</b>: <tt>true</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#arguments">arguments</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Additional arguments to pass to the Maven executions, separated by
+spaces.<br /></td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#autoVersionSubmodules">autoVersionSubmodules</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Whether to automatically assign submodules the parent version. If
set to false, the user will be prompted for the version of each
-submodules.<br />
-<strong>Default value is</strong>: <code>false</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#branchBase">branchBase</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0</code></td>
-<td>The branch base directory in SVN, you must define it if you don't
+submodules.<br /><b>Default value is</b>: <tt>false</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#branchBase">branchBase</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0</tt></td>
+ <td>The branch base directory in SVN, you must define it if you don't
use the standard svn layout (trunk/tags/branches). For example,
-<code>http://svn.apache.org/repos/asf/maven/plugins/branches</code>.
+<tt>http://svn.apache.org/repos/asf/maven/plugins/branches</tt>.
The URL is an SVN URL and does not include the SCM provider and
-protocol.<br />
-</td>
-</tr>
-<tr class="b"><td><strong><a href="#checkModificationExcludeList">checkModificationExcludeList</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.1</code></td>
-<td>Command-line version of checkModificationExcludes<br />
-</td>
-</tr>
-<tr class="a"><td><strong><a href="#checkModificationExcludes">checkModificationExcludes</a></strong></td>
-<td><code>String[]</code></td>
-<td><code>2.1</code></td>
-<td>Additional files that will skipped when checking for modifications
+protocol.<br /></td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#checkModificationExcludeList">checkModificationExcludeList</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.1</tt></td>
+ <td>Command-line version of checkModificationExcludes<br /></td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#checkModificationExcludes">checkModificationExcludes</a></b></td>
+ <td><tt>String[]</tt></td>
+ <td><tt>2.1</tt></td>
+ <td>Additional files that will skipped when checking for modifications
on the working copy. Is ignored, when checkModificationExcludes is
-set.<br />
-</td>
-</tr>
-<tr class="b"><td><strong><a href="#developmentVersion">developmentVersion</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0</code></td>
-<td>Default version to use for new local working copy.<br />
-</td>
-</tr>
-<tr class="a"><td><strong><a href="#dryRun">dryRun</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Dry run: don't checkin or tag anything in the scm repository, or
-modify the checkout. Running <code>mvn -DdryRun=true
-release:prepare</code> is useful in order to check that
+set.<br /></td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#developmentVersion">developmentVersion</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0</tt></td>
+ <td>Default version to use for new local working copy.<br /></td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#dryRun">dryRun</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Dry run: don't checkin or tag anything in the scm repository, or
+modify the checkout. Running <tt>mvn -DdryRun=true
+release:prepare</tt> is useful in order to check that
modifications to poms and scm operations (only listed on the
console) are working as expected. Modified POMs are written
-alongside the originals without modifying them.<br />
-<strong>Default value is</strong>: <code>false</code>.</td>
-</tr>
-<tr class="b"><td><strong><a href="#javaHome">javaHome</a></strong></td>
-<td><code>File</code></td>
-<td><code>2.0-beta-8</code></td>
-<td>The JAVA_HOME parameter to use for forked Maven invocations.<br />
-<strong>Default value is</strong>: <code>${java.home}</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#localCheckout">localCheckout</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0</code></td>
-<td>Use a local checkout instead of doing a checkout from the upstream
+alongside the originals without modifying them.<br /><b>Default value is</b>: <tt>false</tt>.</td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#javaHome">javaHome</a></b></td>
+ <td><tt>File</tt></td>
+ <td><tt>2.0-beta-8</tt></td>
+ <td>The JAVA_HOME parameter to use for forked Maven invocations.<br /><b>Default value is</b>: <tt>${java.home}</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#localCheckout">localCheckout</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0</tt></td>
+ <td>Use a local checkout instead of doing a checkout from the upstream
repository. ATTENTION: This will only work with distributed SCMs
which support the file:// protocol like e.g. git, jgit or hg! TODO:
we should think about having the defaults for the various SCM
-providers provided via modello!<br />
-<strong>Default value is</strong>: <code>false</code>.</td>
-</tr>
-<tr class="b"><td><strong><a href="#localRepoDirectory">localRepoDirectory</a></strong></td>
-<td><code>File</code></td>
-<td><code>2.0-beta-8</code></td>
-<td>The command-line local repository directory in use for this build
-(if specified).<br />
-<strong>Default value is</strong>: <code>${maven.repo.local}</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#mavenExecutorId">mavenExecutorId</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-8</code></td>
-<td>Role hint of the <code>MavenExecutor</code> implementation to use.<br />
-<strong>Default value is</strong>: <code>invoker</code>.</td>
-</tr>
-<tr class="b"><td><strong><a href="#mavenHome">mavenHome</a></strong></td>
-<td><code>File</code></td>
-<td><code>2.0-beta-8</code></td>
-<td>The M2_HOME parameter to use for forked Maven invocations.<br />
-<strong>Default value is</strong>: <code>${maven.home}</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#password">password</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>The SCM password to use.<br />
-</td>
-</tr>
-<tr class="b"><td><strong><a href="#pomFileName">pomFileName</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>The file name of the POM to execute any goals against.<br />
-</td>
-</tr>
-<tr class="a"><td><strong><a href="#providerImplementations">providerImplementations</a></strong></td>
-<td><code>Map</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>List of provider implementations.<br />
-</td>
-</tr>
-<tr class="b"><td><strong><a href="#pushChanges">pushChanges</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.1</code></td>
-<td>Implemented with git will or not push changes to the upstream
-repository. <code>true</code> by default to preserve backward
-compatibility.<br />
-<strong>Default value is</strong>: <code>true</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#releaseVersion">releaseVersion</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0</code></td>
-<td>Default version to use when preparing a release or a branch.<br />
-</td>
-</tr>
-<tr class="b"><td><strong><a href="#remoteTagging">remoteTagging</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0</code></td>
-<td>currently only implemented with svn scm. Enable a workaround to
+providers provided via modello!<br /><b>Default value is</b>: <tt>false</tt>.</td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#localRepoDirectory">localRepoDirectory</a></b></td>
+ <td><tt>File</tt></td>
+ <td><tt>2.0-beta-8</tt></td>
+ <td>The command-line local repository directory in use for this build
+(if specified).<br /><b>Default value is</b>: <tt>${maven.repo.local}</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#mavenExecutorId">mavenExecutorId</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-8</tt></td>
+ <td>Role hint of the <tt>MavenExecutor</tt> implementation to use.<br /><b>Default value is</b>: <tt>invoker</tt>.</td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#mavenHome">mavenHome</a></b></td>
+ <td><tt>File</tt></td>
+ <td><tt>2.0-beta-8</tt></td>
+ <td>The M2_HOME parameter to use for forked Maven invocations.<br /><b>Default value is</b>: <tt>${maven.home}</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#password">password</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>The SCM password to use.<br /></td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#pomFileName">pomFileName</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>The file name of the POM to execute any goals against.<br /></td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#providerImplementations">providerImplementations</a></b></td>
+ <td><tt>Map</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>List of provider implementations.<br /></td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#pushChanges">pushChanges</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.1</tt></td>
+ <td>Implemented with git will or not push changes to the upstream
+repository. <tt>true</tt> by default to preserve backward
+compatibility.<br /><b>Default value is</b>: <tt>true</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#releaseVersion">releaseVersion</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0</tt></td>
+ <td>Default version to use when preparing a release or a branch.<br /></td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#remoteTagging">remoteTagging</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0</tt></td>
+ <td>currently only implemented with svn scm. Enable a workaround to
prevent issue due to svn client > 1.5.0
-(http://jira.codehaus.org/browse/SCM-406)<br />
-<strong>Default value is</strong>: <code>true</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#scmCommentPrefix">scmCommentPrefix</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-5</code></td>
-<td>The message prefix to use for all SCM changes.<br />
-<strong>Default value is</strong>: <code>[maven-release-plugin] </code>.</td>
-</tr>
-<tr class="b"><td><strong><a href="#suppressCommitBeforeBranch">suppressCommitBeforeBranch</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.1</code></td>
-<td>Whether to suppress a commit of changes to the working copy before
+(http://jira.codehaus.org/browse/SCM-406)<br /><b>Default value is</b>: <tt>true</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#scmCommentPrefix">scmCommentPrefix</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-5</tt></td>
+ <td>The message prefix to use for all SCM changes.<br /><b>Default value is</b>: <tt>[maven-release-plugin] </tt>.</td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#suppressCommitBeforeBranch">suppressCommitBeforeBranch</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.1</tt></td>
+ <td>Whether to suppress a commit of changes to the working copy before
the tag is created. <br />
<br />
-
-This requires <code>remoteTagging</code> to be set to false. <br />
+This requires <tt>remoteTagging</tt> to be set to false. <br />
<br />
-<code>suppressCommitBeforeBranch</code> is useful when you want to
+<tt>suppressCommitBeforeBranch</tt> is useful when you want to
avoid poms with released versions in all revisions of your trunk or
-development branch.<br />
-<strong>Default value is</strong>: <code>false</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#tag">tag</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>The SCM tag to use.<br />
-</td>
-</tr>
-<tr class="b"><td><strong><a href="#tagBase">tagBase</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>The tag base directory in SVN, you must define it if you don't use
+development branch.<br /><b>Default value is</b>: <tt>false</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#tag">tag</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>The SCM tag to use.<br /></td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#tagBase">tagBase</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>The tag base directory in SVN, you must define it if you don't use
the standard svn layout (trunk/tags/branches). For example,
-<code>http://svn.apache.org/repos/asf/maven/plugins/tags</code>.
+<tt>http://svn.apache.org/repos/asf/maven/plugins/tags</tt>.
The URL is an SVN URL and does not include the SCM provider and
-protocol.<br />
-</td>
-</tr>
-<tr class="a"><td><strong><a href="#updateBranchVersions">updateBranchVersions</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Whether to update versions in the branch.<br />
-<strong>Default value is</strong>: <code>false</code>.</td>
-</tr>
-<tr class="b"><td><strong><a href="#updateDependencies">updateDependencies</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Whether to update dependencies version to the next development
-version.<br />
-<strong>Default value is</strong>: <code>true</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#updateVersionsToSnapshot">updateVersionsToSnapshot</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Whether to update versions to SNAPSHOT in the branch.<br />
-<strong>Default value is</strong>: <code>true</code>.</td>
-</tr>
-<tr class="b"><td><strong><a href="#updateWorkingCopyVersions">updateWorkingCopyVersions</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Whether to update versions in the working copy.<br />
-<strong>Default value is</strong>: <code>true</code>.</td>
-</tr>
-<tr class="a"><td><strong><a href="#useEditMode">useEditMode</a></strong></td>
-<td><code>boolean</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>Whether to use "edit" mode on the SCM, to lock the file for editing
-during SCM operations.<br />
-<strong>Default value is</strong>: <code>false</code>.</td>
-</tr>
-<tr class="b"><td><strong><a href="#username">username</a></strong></td>
-<td><code>String</code></td>
-<td><code>2.0-beta-6</code></td>
-<td>The SCM username to use.<br />
-</td>
-</tr>
-</table>
-</div>
-<div class="section"><h3><a name="Parameter_Details"></a>Parameter Details</h3>
-<p><strong><a name="addSchema">addSchema</a>:</strong></p>
-<div>Whether to add a schema to the POM if it was previously missing on
-release.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${addSchema}</code></li>
-<li><strong>Default</strong>: <code>true</code></li>
-</ul>
-<hr />
-<p><strong><a name="arguments">arguments</a>:</strong></p>
-<div>Additional arguments to pass to the Maven executions, separated by
-spaces.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${arguments}</code></li>
-</ul>
-<hr />
-<p><strong><a name="autoVersionSubmodules">autoVersionSubmodules</a>:</strong></p>
-<div>Whether to automatically assign submodules the parent version. If
+protocol.<br /></td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#tagNameFormat">tagNameFormat</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.2.0</tt></td>
+ <td>Format to use when generating the tag name if none is specified.
+Property interpolation is performed on the tag, but in order to
+ensure that the interpolation occurs during release, you must use
+<tt>@{...}</tt> to reference the properties rather than
+<tt>${...}</tt>. The following properties are available:
+
+<ul>
+<li><tt>groupId</tt> or <tt>project.groupId</tt> - The
+groupId of the root project.</li>
+
+<li><tt>artifactId</tt> or <tt>project.artifactId</tt> -
+The artifactId of the root project.</li>
+
+<li><tt>version</tt> or <tt>project.version</tt> - The
+release version of the root project.</li>
+</ul><br /><b>Default value is</b>: <tt>@{project.artifactId}-@{project.version}</tt>.</td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#updateBranchVersions">updateBranchVersions</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Whether to update versions in the branch.<br /><b>Default value is</b>: <tt>false</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#updateDependencies">updateDependencies</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Whether to update dependencies version to the next development
+version.<br /><b>Default value is</b>: <tt>true</tt>.</td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#updateVersionsToSnapshot">updateVersionsToSnapshot</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Whether to update versions to SNAPSHOT in the branch.<br /><b>Default value is</b>: <tt>true</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#updateWorkingCopyVersions">updateWorkingCopyVersions</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Whether to update versions in the working copy.<br /><b>Default value is</b>: <tt>true</tt>.</td>
+ </tr>
+ <tr class="b">
+ <td><b><a href="#useEditMode">useEditMode</a></b></td>
+ <td><tt>boolean</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>Whether to use "edit" mode on the SCM, to lock the file for editing
+during SCM operations.<br /><b>Default value is</b>: <tt>false</tt>.</td>
+ </tr>
+ <tr class="a">
+ <td><b><a href="#username">username</a></b></td>
+ <td><tt>String</tt></td>
+ <td><tt>2.0-beta-6</tt></td>
+ <td>The SCM username to use.<br /></td>
+ </tr>
+ </table>
+ </div>
+ <div class="section"><h3>Parameter Details<a name="Parameter_Details"></a></h3>
+ <p><b><a name="addSchema">addSchema</a>:</b></p>
+ <div>Whether to add a schema to the POM if it was previously missing on
+release.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${addSchema}</tt></li>
+ <li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr /><p><b><a name="arguments">arguments</a>:</b></p>
+ <div>Additional arguments to pass to the Maven executions, separated by
+spaces.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${arguments}</tt></li>
+ </ul><hr /><p><b><a name="autoVersionSubmodules">autoVersionSubmodules</a>:</b></p>
+ <div>Whether to automatically assign submodules the parent version. If
set to false, the user will be prompted for the version of each
-submodules.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${autoVersionSubmodules}</code></li>
-<li><strong>Default</strong>: <code>false</code></li>
-</ul>
-<hr />
-<p><strong><a name="branchBase">branchBase</a>:</strong></p>
-<div>The branch base directory in SVN, you must define it if you don't
+submodules.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${autoVersionSubmodules}</tt></li>
+ <li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr /><p><b><a name="branchBase">branchBase</a>:</b></p>
+ <div>The branch base directory in SVN, you must define it if you don't
use the standard svn layout (trunk/tags/branches). For example,
-<code>http://svn.apache.org/repos/asf/maven/plugins/branches</code>.
+<tt>http://svn.apache.org/repos/asf/maven/plugins/branches</tt>.
The URL is an SVN URL and does not include the SCM provider and
-protocol.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${branchBase}</code></li>
-</ul>
-<hr />
-<p><strong><a name="branchName">branchName</a>:</strong></p>
-<div>The branch name to use.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>Yes</code></li>
-<li><strong>Expression</strong>: <code>${branchName}</code></li>
-</ul>
-<hr />
-<p><strong><a name="checkModificationExcludeList">checkModificationExcludeList</a>:</strong></p>
-<div>Command-line version of checkModificationExcludes</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.1</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${checkModificationExcludeList}</code></li>
-</ul>
-<hr />
-<p><strong><a name="checkModificationExcludes">checkModificationExcludes</a>:</strong></p>
-<div>Additional files that will skipped when checking for modifications
+protocol.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${branchBase}</tt></li>
+ </ul><hr /><p><b><a name="branchName">branchName</a>:</b></p>
+ <div>The branch name to use.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>Yes</tt></li>
+ <li><b>Expression</b>: <tt>${branchName}</tt></li>
+ </ul><hr /><p><b><a name="checkModificationExcludeList">checkModificationExcludeList</a>:</b></p>
+ <div>Command-line version of checkModificationExcludes</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.1</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${checkModificationExcludeList}</tt></li>
+ </ul><hr /><p><b><a name="checkModificationExcludes">checkModificationExcludes</a>:</b></p>
+ <div>Additional files that will skipped when checking for modifications
on the working copy. Is ignored, when checkModificationExcludes is
-set.</div><ul><li><strong>Type</strong>: <code>java.lang.String[]</code></li>
-<li><strong>Since</strong>: <code>2.1</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-</ul>
-<hr />
-<p><strong><a name="developmentVersion">developmentVersion</a>:</strong></p>
-<div>Default version to use for new local working copy.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${developmentVersion}</code></li>
-</ul>
-<hr />
-<p><strong><a name="dryRun">dryRun</a>:</strong></p>
-<div>Dry run: don't checkin or tag anything in the scm repository, or
-modify the checkout. Running <code>mvn -DdryRun=true
-release:prepare</code> is useful in order to check that
+set.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String[]</tt></li>
+ <li><b>Since</b>: <tt>2.1</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr /><p><b><a name="developmentVersion">developmentVersion</a>:</b></p>
+ <div>Default version to use for new local working copy.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${developmentVersion}</tt></li>
+ </ul><hr /><p><b><a name="dryRun">dryRun</a>:</b></p>
+ <div>Dry run: don't checkin or tag anything in the scm repository, or
+modify the checkout. Running <tt>mvn -DdryRun=true
+release:prepare</tt> is useful in order to check that
modifications to poms and scm operations (only listed on the
console) are working as expected. Modified POMs are written
-alongside the originals without modifying them.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${dryRun}</code></li>
-<li><strong>Default</strong>: <code>false</code></li>
-</ul>
-<hr />
-<p><strong><a name="javaHome">javaHome</a>:</strong></p>
-<div>The JAVA_HOME parameter to use for forked Maven invocations.</div><ul><li><strong>Type</strong>: <code>java.io.File</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-8</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Default</strong>: <code>${java.home}</code></li>
-</ul>
-<hr />
-<p><strong><a name="localCheckout">localCheckout</a>:</strong></p>
-<div>Use a local checkout instead of doing a checkout from the upstream
+alongside the originals without modifying them.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${dryRun}</tt></li>
+ <li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr /><p><b><a name="javaHome">javaHome</a>:</b></p>
+ <div>The JAVA_HOME parameter to use for forked Maven invocations.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.io.File</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-8</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Default</b>: <tt>${java.home}</tt></li>
+ </ul><hr /><p><b><a name="localCheckout">localCheckout</a>:</b></p>
+ <div>Use a local checkout instead of doing a checkout from the upstream
repository. ATTENTION: This will only work with distributed SCMs
which support the file:// protocol like e.g. git, jgit or hg! TODO:
we should think about having the defaults for the various SCM
-providers provided via modello!</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${localCheckout}</code></li>
-<li><strong>Default</strong>: <code>false</code></li>
-</ul>
-<hr />
-<p><strong><a name="localRepoDirectory">localRepoDirectory</a>:</strong></p>
-<div>The command-line local repository directory in use for this build
-(if specified).</div><ul><li><strong>Type</strong>: <code>java.io.File</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-8</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Default</strong>: <code>${maven.repo.local}</code></li>
-</ul>
-<hr />
-<p><strong><a name="mavenExecutorId">mavenExecutorId</a>:</strong></p>
-<div>Role hint of the <code>MavenExecutor</code> implementation to use.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-8</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${mavenExecutorId}</code></li>
-<li><strong>Default</strong>: <code>invoker</code></li>
-</ul>
-<hr />
-<p><strong><a name="mavenHome">mavenHome</a>:</strong></p>
-<div>The M2_HOME parameter to use for forked Maven invocations.</div><ul><li><strong>Type</strong>: <code>java.io.File</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-8</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Default</strong>: <code>${maven.home}</code></li>
-</ul>
-<hr />
-<p><strong><a name="password">password</a>:</strong></p>
-<div>The SCM password to use.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${password}</code></li>
-</ul>
-<hr />
-<p><strong><a name="pomFileName">pomFileName</a>:</strong></p>
-<div>The file name of the POM to execute any goals against.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${pomFileName}</code></li>
-</ul>
-<hr />
-<p><strong><a name="providerImplementations">providerImplementations</a>:</strong></p>
-<div>List of provider implementations.</div><ul><li><strong>Type</strong>: <code>java.util.Map</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-</ul>
-<hr />
-<p><strong><a name="pushChanges">pushChanges</a>:</strong></p>
-<div>Implemented with git will or not push changes to the upstream
-repository. <code>true</code> by default to preserve backward
-compatibility.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.1</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${pushChanges}</code></li>
-<li><strong>Default</strong>: <code>true</code></li>
-</ul>
-<hr />
-<p><strong><a name="releaseVersion">releaseVersion</a>:</strong></p>
-<div>Default version to use when preparing a release or a branch.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${releaseVersion}</code></li>
-</ul>
-<hr />
-<p><strong><a name="remoteTagging">remoteTagging</a>:</strong></p>
-<div>currently only implemented with svn scm. Enable a workaround to
+providers provided via modello!</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${localCheckout}</tt></li>
+ <li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr /><p><b><a name="localRepoDirectory">localRepoDirectory</a>:</b></p>
+ <div>The command-line local repository directory in use for this build
+(if specified).</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.io.File</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-8</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Default</b>: <tt>${maven.repo.local}</tt></li>
+ </ul><hr /><p><b><a name="mavenExecutorId">mavenExecutorId</a>:</b></p>
+ <div>Role hint of the <tt>MavenExecutor</tt> implementation to use.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-8</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${mavenExecutorId}</tt></li>
+ <li><b>Default</b>: <tt>invoker</tt></li>
+ </ul><hr /><p><b><a name="mavenHome">mavenHome</a>:</b></p>
+ <div>The M2_HOME parameter to use for forked Maven invocations.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.io.File</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-8</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Default</b>: <tt>${maven.home}</tt></li>
+ </ul><hr /><p><b><a name="password">password</a>:</b></p>
+ <div>The SCM password to use.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${password}</tt></li>
+ </ul><hr /><p><b><a name="pomFileName">pomFileName</a>:</b></p>
+ <div>The file name of the POM to execute any goals against.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${pomFileName}</tt></li>
+ </ul><hr /><p><b><a name="providerImplementations">providerImplementations</a>:</b></p>
+ <div>List of provider implementations.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.util.Map</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ </ul><hr /><p><b><a name="pushChanges">pushChanges</a>:</b></p>
+ <div>Implemented with git will or not push changes to the upstream
+repository. <tt>true</tt> by default to preserve backward
+compatibility.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.1</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${pushChanges}</tt></li>
+ <li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr /><p><b><a name="releaseVersion">releaseVersion</a>:</b></p>
+ <div>Default version to use when preparing a release or a branch.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${releaseVersion}</tt></li>
+ </ul><hr /><p><b><a name="remoteTagging">remoteTagging</a>:</b></p>
+ <div>currently only implemented with svn scm. Enable a workaround to
prevent issue due to svn client > 1.5.0
-(http://jira.codehaus.org/browse/SCM-406)</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${remoteTagging}</code></li>
-<li><strong>Default</strong>: <code>true</code></li>
-</ul>
-<hr />
-<p><strong><a name="scmCommentPrefix">scmCommentPrefix</a>:</strong></p>
-<div>The message prefix to use for all SCM changes.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-5</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${scmCommentPrefix}</code></li>
-<li><strong>Default</strong>: <code>[maven-release-plugin] </code></li>
-</ul>
-<hr />
-<p><strong><a name="suppressCommitBeforeBranch">suppressCommitBeforeBranch</a>:</strong></p>
-<div>Whether to suppress a commit of changes to the working copy before
+(http://jira.codehaus.org/browse/SCM-406)</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${remoteTagging}</tt></li>
+ <li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr /><p><b><a name="scmCommentPrefix">scmCommentPrefix</a>:</b></p>
+ <div>The message prefix to use for all SCM changes.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-5</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${scmCommentPrefix}</tt></li>
+ <li><b>Default</b>: <tt>[maven-release-plugin] </tt></li>
+ </ul><hr /><p><b><a name="suppressCommitBeforeBranch">suppressCommitBeforeBranch</a>:</b></p>
+ <div>Whether to suppress a commit of changes to the working copy before
the tag is created. <br />
<br />
-
-This requires <code>remoteTagging</code> to be set to false. <br />
+This requires <tt>remoteTagging</tt> to be set to false. <br />
<br />
-<code>suppressCommitBeforeBranch</code> is useful when you want to
+<tt>suppressCommitBeforeBranch</tt> is useful when you want to
avoid poms with released versions in all revisions of your trunk or
-development branch.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.1</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${suppressCommitBeforeBranch}</code></li>
-<li><strong>Default</strong>: <code>false</code></li>
-</ul>
-<hr />
-<p><strong><a name="tag">tag</a>:</strong></p>
-<div>The SCM tag to use.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${tag}</code></li>
-</ul>
-<hr />
-<p><strong><a name="tagBase">tagBase</a>:</strong></p>
-<div>The tag base directory in SVN, you must define it if you don't use
+development branch.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.1</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${suppressCommitBeforeBranch}</tt></li>
+ <li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr /><p><b><a name="tag">tag</a>:</b></p>
+ <div>The SCM tag to use.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${tag}</tt></li>
+ </ul><hr /><p><b><a name="tagBase">tagBase</a>:</b></p>
+ <div>The tag base directory in SVN, you must define it if you don't use
the standard svn layout (trunk/tags/branches). For example,
-<code>http://svn.apache.org/repos/asf/maven/plugins/tags</code>.
+<tt>http://svn.apache.org/repos/asf/maven/plugins/tags</tt>.
The URL is an SVN URL and does not include the SCM provider and
-protocol.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${tagBase}</code></li>
-</ul>
-<hr />
-<p><strong><a name="updateBranchVersions">updateBranchVersions</a>:</strong></p>
-<div>Whether to update versions in the branch.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${updateBranchVersions}</code></li>
-<li><strong>Default</strong>: <code>false</code></li>
-</ul>
-<hr />
-<p><strong><a name="updateDependencies">updateDependencies</a>:</strong></p>
-<div>Whether to update dependencies version to the next development
-version.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${updateDependencies}</code></li>
-<li><strong>Default</strong>: <code>true</code></li>
-</ul>
-<hr />
-<p><strong><a name="updateVersionsToSnapshot">updateVersionsToSnapshot</a>:</strong></p>
-<div>Whether to update versions to SNAPSHOT in the branch.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${updateVersionsToSnapshot}</code></li>
-<li><strong>Default</strong>: <code>true</code></li>
-</ul>
-<hr />
-<p><strong><a name="updateWorkingCopyVersions">updateWorkingCopyVersions</a>:</strong></p>
-<div>Whether to update versions in the working copy.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${updateWorkingCopyVersions}</code></li>
-<li><strong>Default</strong>: <code>true</code></li>
-</ul>
-<hr />
-<p><strong><a name="useEditMode">useEditMode</a>:</strong></p>
-<div>Whether to use "edit" mode on the SCM, to lock the file for editing
-during SCM operations.</div><ul><li><strong>Type</strong>: <code>boolean</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${useEditMode}</code></li>
-<li><strong>Default</strong>: <code>false</code></li>
-</ul>
-<hr />
-<p><strong><a name="username">username</a>:</strong></p>
-<div>The SCM username to use.</div><ul><li><strong>Type</strong>: <code>java.lang.String</code></li>
-<li><strong>Since</strong>: <code>2.0-beta-6</code></li>
-<li><strong>Required</strong>: <code>No</code></li>
-<li><strong>Expression</strong>: <code>${username}</code></li>
-</ul>
-</div>
-</div>
+protocol.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${tagBase}</tt></li>
+ </ul><hr /><p><b><a name="tagNameFormat">tagNameFormat</a>:</b></p>
+ <div>Format to use when generating the tag name if none is specified.
+Property interpolation is performed on the tag, but in order to
+ensure that the interpolation occurs during release, you must use
+<tt>@{...}</tt> to reference the properties rather than
+<tt>${...}</tt>. The following properties are available:
+
+<ul>
+<li><tt>groupId</tt> or <tt>project.groupId</tt> - The
+groupId of the root project.</li>
+
+<li><tt>artifactId</tt> or <tt>project.artifactId</tt> -
+The artifactId of the root project.</li>
+
+<li><tt>version</tt> or <tt>project.version</tt> - The
+release version of the root project.</li>
+</ul></div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.2.0</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${tagNameFormat}</tt></li>
+ <li><b>Default</b>: <tt>@{project.artifactId}-@{project.version}</tt></li>
+ </ul><hr /><p><b><a name="updateBranchVersions">updateBranchVersions</a>:</b></p>
+ <div>Whether to update versions in the branch.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${updateBranchVersions}</tt></li>
+ <li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr /><p><b><a name="updateDependencies">updateDependencies</a>:</b></p>
+ <div>Whether to update dependencies version to the next development
+version.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${updateDependencies}</tt></li>
+ <li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr /><p><b><a name="updateVersionsToSnapshot">updateVersionsToSnapshot</a>:</b></p>
+ <div>Whether to update versions to SNAPSHOT in the branch.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${updateVersionsToSnapshot}</tt></li>
+ <li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr /><p><b><a name="updateWorkingCopyVersions">updateWorkingCopyVersions</a>:</b></p>
+ <div>Whether to update versions in the working copy.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${updateWorkingCopyVersions}</tt></li>
+ <li><b>Default</b>: <tt>true</tt></li>
+ </ul><hr /><p><b><a name="useEditMode">useEditMode</a>:</b></p>
+ <div>Whether to use "edit" mode on the SCM, to lock the file for editing
+during SCM operations.</div>
+ <ul>
+ <li><b>Type</b>: <tt>boolean</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${useEditMode}</tt></li>
+ <li><b>Default</b>: <tt>false</tt></li>
+ </ul><hr /><p><b><a name="username">username</a>:</b></p>
+ <div>The SCM username to use.</div>
+ <ul>
+ <li><b>Type</b>: <tt>java.lang.String</tt></li>
+ <li><b>Since</b>: <tt>2.0-beta-6</tt></li>
+ <li><b>Required</b>: <tt>No</tt></li>
+ <li><b>Expression</b>: <tt>${username}</tt></li>
+ </ul>
+ </div>
+ </div>
+
</div>
</div>
@@ -790,7 +849,7 @@ during SCM operations.</div><ul><li><str
</div>
<div id="footer">
<div class="xright">©
- 2002-2010
+ 2002-2011
The Apache Software Foundation