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 [8/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/examples/generate-release-poms.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/generate-release-poms.html (original)
+++ websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/generate-release-poms.html Tue May 8 11:38:11 2012
@@ -12,7 +12,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <title>Maven Release plugin - Generate Release POMs</title>
+ <title>Generate Release POMs</title>
<style type="text/css" media="all">
@import url("../css/maven-base.css");
@import url("../css/maven-theme.css");
@@ -31,16 +31,16 @@ John Tolentino jtolentino@apache.org" />
</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>
@@ -59,13 +59,16 @@ John Tolentino jtolentino@apache.org" />
<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">
@@ -75,8 +78,8 @@ John Tolentino jtolentino@apache.org" />
- Last Published: 2010-10-04
- | Version: 2.1
+ Last Published: 2011-06-27
+ | Version: 2.2
</div>
<div class="clear">
<hr/>
@@ -96,65 +99,65 @@ John Tolentino jtolentino@apache.org" />
<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>
- </li>
+ <strong>Generate Release POMs</strong>
+ </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>
@@ -182,6 +185,8 @@ John Tolentino jtolentino@apache.org" />
+
+
<li class="collapsed">
<a href="../project-info.html">Project Information</a>
@@ -219,47 +224,47 @@ John Tolentino jtolentino@apache.org" />
<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">
@@ -277,17 +282,8 @@ John Tolentino jtolentino@apache.org" />
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2>Generate Release POMs</h2>
-<p>To generate POMs with resolved information (e.g. version numbers) to check the values that the Release Plugin will use, set the property <tt>generateReleasePoms</tt> to <tt>true</tt>. Resolved values will be saved in <tt>release-pom.xml</tt>.</p>
-<div class="source"><pre>mvn release:prepare -DgenerateReleasePoms=true</pre>
-</div>
-<p>This relies on <tt>release.properties</tt> being present from a previous release preparation. If this is not the case, you need to give the goal the name of the URL and optional tag to perform the release from. For example:</p>
-<div class="source"><pre>mvn release:prepare -DgenerateReleasePoms=true
- -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0</pre>
-</div>
-<p>After the release is complete, the <tt>release.properties</tt> and other release files will be removed from the checkout.</p>
-</div>
-
+ <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License. You may obtain a copy of the License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section"><h2>Generate Release POMs<a name="Generate_Release_POMs"></a></h2><p>To generat
e POMs with resolved information (e.g. version numbers) to check the values that the Release Plugin will use, set the property <tt>generateReleasePoms</tt> to <tt>true</tt>. Resolved values will be saved in <tt>release-pom.xml</tt>.</p><div><pre>mvn release:prepare -DgenerateReleasePoms=true</pre></div><p>This relies on <tt>release.properties</tt> being present from a previous release preparation. If this is not the case, you need to give the goal the name of the URL and optional tag to perform the release from. For example:</p><div><pre>mvn release:prepare -DgenerateReleasePoms=true
+ -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0</pre></div><p>After the release is complete, the <tt>release.properties</tt> and other release files will be removed from the checkout.</p></div>
</div>
</div>
<div class="clear">
@@ -295,7 +291,7 @@ John Tolentino jtolentino@apache.org" />
</div>
<div id="footer">
<div class="xright">©
- 2002-2010
+ 2002-2011
The Apache Software Foundation
Modified: websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/lock-files.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/lock-files.html (original)
+++ websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/lock-files.html Tue May 8 11:38:11 2012
@@ -12,7 +12,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <title>Maven Release plugin - Lock Files During Release</title>
+ <title>Lock Files During Release</title>
<style type="text/css" media="all">
@import url("../css/maven-base.css");
@import url("../css/maven-theme.css");
@@ -31,16 +31,16 @@ John Tolentino jtolentino@apache.org" />
</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>
@@ -59,13 +59,16 @@ John Tolentino jtolentino@apache.org" />
<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">
@@ -75,8 +78,8 @@ John Tolentino jtolentino@apache.org" />
- Last Published: 2010-10-04
- | Version: 2.1
+ Last Published: 2011-06-27
+ | Version: 2.2
</div>
<div class="clear">
<hr/>
@@ -96,65 +99,65 @@ John Tolentino jtolentino@apache.org" />
<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>
- </li>
+ <strong>Lock Files During Release</strong>
+ </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>
@@ -182,6 +185,8 @@ John Tolentino jtolentino@apache.org" />
+
+
<li class="collapsed">
<a href="../project-info.html">Project Information</a>
@@ -219,47 +224,47 @@ John Tolentino jtolentino@apache.org" />
<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">
@@ -277,17 +282,8 @@ John Tolentino jtolentino@apache.org" />
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2>Lock Files During Release</h2>
-<p>If you want to lock the files during a release operation set the property <tt>useEditMode</tt> to <tt>true</tt>. The default value of this property is <tt>false</tt>.</p>
-<div class="source"><pre>mvn release:perform -DuseEditMode=true</pre>
-</div>
-<p>This relies on <tt>release.properties</tt> being present from a previous release preparation. If this is not the case, you need to give the goal the name of the URL and optional tag to perform the release from. For example:</p>
-<div class="source"><pre>mvn release:perform -DuseEditMode=true
- -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0</pre>
-</div>
-<p>After the release is complete, the <tt>release.properties</tt> and other release files will be removed from the checkout.</p>
-</div>
-
+ <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License. You may obtain a copy of the License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><!-- NOTE: For help with the syntax of this file, see: --><!-- http://maven.apache.org/doxia/referen
ces/apt-format.html --><div class="section"><h2>Lock Files During Release<a name="Lock_Files_During_Release"></a></h2><p>If you want to lock the files during a release operation set the property <tt>useEditMode</tt> to <tt>true</tt>. The default value of this property is <tt>false</tt>.</p><div><pre>mvn release:perform -DuseEditMode=true</pre></div><p>This relies on <tt>release.properties</tt> being present from a previous release preparation. If this is not the case, you need to give the goal the name of the URL and optional tag to perform the release from. For example:</p><div><pre>mvn release:perform -DuseEditMode=true
+ -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0</pre></div><p>After the release is complete, the <tt>release.properties</tt> and other release files will be removed from the checkout.</p></div>
</div>
</div>
<div class="clear">
@@ -295,7 +291,7 @@ John Tolentino jtolentino@apache.org" />
</div>
<div id="footer">
<div class="xright">©
- 2002-2010
+ 2002-2011
The Apache Software Foundation
Modified: websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/non-interactive-release.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/non-interactive-release.html (original)
+++ websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/non-interactive-release.html Tue May 8 11:38:11 2012
@@ -12,7 +12,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <title>Maven Release plugin - Performing a Non-interactive Release</title>
+ <title>Performing a Non-interactive Release</title>
<style type="text/css" media="all">
@import url("../css/maven-base.css");
@import url("../css/maven-theme.css");
@@ -29,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>
@@ -57,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">
@@ -73,8 +76,8 @@
- Last Published: 2010-10-04
- | Version: 2.1
+ Last Published: 2011-06-27
+ | Version: 2.2
</div>
<div class="clear">
<hr/>
@@ -94,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>
- </li>
+ <strong>Non-interactive Release</strong>
+ </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>
@@ -180,6 +183,8 @@
+
+
<li class="collapsed">
<a href="../project-info.html">Project Information</a>
@@ -217,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">
@@ -275,40 +280,12 @@
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2>Performing a Non-interactive Release</h2>
-<p>In some environments, it may be necessary to perform a non-interactive release. This means that the Release Plugin will obtain the required parameters from system properties (set on the command line) or from a properties file (<tt>release.properties</tt>).</p>
-<p>To prevent the Release Plugin from promting the user for any information, Maven should be put into batch mode.</p>
-<div class="source"><pre>mvn -B release:prepare</pre>
-</div>
-<p>or</p>
-<div class="source"><pre>mvn --batch-mode release:prepare</pre>
-</div>
-<div class="section"><h3>Using system properties</h3>
-<p>Using batch mode with no other configuration will cause the Release Plugin to use default values for the release version, the SCM tag, and the next development version. These values can also be set from the command line.</p>
-<p>The SCM tag name can be set using the <tt>tag</tt> property. And default values for the release version and new development version can be set using the properties <tt>releaseVersion</tt> and <tt>developmentVersion</tt> respectively.</p>
-<div class="source"><pre>mvn --batch-mode -Dtag=my-proj-1.2 release:prepare \
+ <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License. You may obtain a copy of the License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section"><h2>Performing a Non-interactive Release<a name="Performing_a_Non-interactive_R
elease"></a></h2><p>In some environments, it may be necessary to perform a non-interactive release. This means that the Release Plugin will obtain the required parameters from system properties (set on the command line) or from a properties file (<tt>release.properties</tt>).</p><p>To prevent the Release Plugin from promting the user for any information, Maven should be put into batch mode.</p><div><pre>mvn -B release:prepare</pre></div><p>or</p><div><pre>mvn --batch-mode release:prepare</pre></div><div class="section"><h3>Using system properties<a name="Using_system_properties"></a></h3><p>Using batch mode with no other configuration will cause the Release Plugin to use default values for the release version, the SCM tag, and the next development version. These values can also be set from the command line.</p><p>The SCM tag name can be set using the <tt>tag</tt> property. And default values for the release version and new development version can be set using the properties
<tt>releaseVersion</tt> and <tt>developmentVersion</tt> respectively.</p><div><pre>mvn --batch-mode -Dtag=my-proj-1.2 release:prepare \
-DreleaseVersion=1.2 \
- -DdevelopmentVersion=2.0-SNAPSHOT</pre>
-</div>
-</div>
-<div class="section"><h3>Multi-module releases</h3>
-<p>Because there is the possibility that a release will include multiple release versions and SNAPSHOT versions (for a multi-module project), there is a specific format for setting these values. The property name should start with <tt>project.rel</tt> for release versions and <tt>project.dev</tt> for the new development version. These prefixes are followed by the project's groupId and artifactId (separated by a colon). So the result looks something like the following example.</p>
-<div class="source"><pre>mvn --batch-mode -Dtag=my-proj-1.2 -Dproject.rel.org.myCompany:projectA=1.2 \
- -Dproject.dev.org.myCompany:projectA=1.3-SNAPSHOT release:prepare</pre>
-</div>
-<p>Using this convention, multiple release versions and SNAPSHOT versions (one for each project module) can be specified on the command line.</p>
-<p>These properties can be used in combination with the <tt>releaseVersion</tt> and <tt>developmentVersion</tt>. In the case where both are used, <tt>releaseVersion</tt> and <tt>developmentVersion</tt> act as defaults for modules that have not been given specific values using the <tt>groupId:artifactId</tt> format.</p>
-</div>
-<div class="section"><h3>Using a properties file</h3>
-<p>Another option is to create a properties file that contains the version information for the project you would like to release. The properties file should be called <tt>release.properties</tt> and the release and SNAPSHOT versions follow the same conventions as they do on the command line.</p>
-<div class="source"><pre>scm.tag=my-proj-1.2
+ -DdevelopmentVersion=2.0-SNAPSHOT</pre></div></div><div class="section"><h3>Multi-module releases<a name="Multi-module_releases"></a></h3><p>Because there is the possibility that a release will include multiple release versions and SNAPSHOT versions (for a multi-module project), there is a specific format for setting these values. The property name should start with <tt>project.rel</tt> for release versions and <tt>project.dev</tt> for the new development version. These prefixes are followed by the project's groupId and artifactId (separated by a colon). So the result looks something like the following example.</p><div><pre>mvn --batch-mode -Dtag=my-proj-1.2 -Dproject.rel.org.myCompany:projectA=1.2 \
+ -Dproject.dev.org.myCompany:projectA=1.3-SNAPSHOT release:prepare</pre></div><p>Using this convention, multiple release versions and SNAPSHOT versions (one for each project module) can be specified on the command line.</p><p>These properties can be used in combination with the <tt>releaseVersion</tt> and <tt>developmentVersion</tt>. In the case where both are used, <tt>releaseVersion</tt> and <tt>developmentVersion</tt> act as defaults for modules that have not been given specific values using the <tt>groupId:artifactId</tt> format.</p></div><div class="section"><h3>Using a properties file<a name="Using_a_properties_file"></a></h3><p>Another option is to create a properties file that contains the version information for the project you would like to release. The properties file should be called <tt>release.properties</tt> and the release and SNAPSHOT versions follow the same conventions as they do on the command line.</p><div><pre>scm.tag=my-proj-1.2
project.rel.org.myCompany\:projectA=1.2
-project.dev.org.myCompany\:projectA=1.3-SNAPSHOT</pre>
-</div>
-<p><b>Note:</b> Remember to escape the colon with a backslash, otherwise the property will not be interpreted correctly.</p>
-</div>
-</div>
-
+project.dev.org.myCompany\:projectA=1.3-SNAPSHOT</pre></div><p><b>Note:</b> Remember to escape the colon with a backslash, otherwise the property will not be interpreted correctly.</p></div></div>
</div>
</div>
<div class="clear">
@@ -316,7 +293,7 @@ project.dev.org.myCompany\:projectA=1.3-
</div>
<div id="footer">
<div class="xright">©
- 2002-2010
+ 2002-2011
The Apache Software Foundation
Modified: websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/perform-release.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/perform-release.html (original)
+++ websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/perform-release.html Tue May 8 11:38:11 2012
@@ -12,7 +12,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <title>Maven Release plugin - Perform a Release</title>
+ <title>Perform a Release</title>
<style type="text/css" media="all">
@import url("../css/maven-base.css");
@import url("../css/maven-theme.css");
@@ -31,16 +31,16 @@ John Tolentino jtolentino@apache.org" />
</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>
@@ -59,13 +59,16 @@ John Tolentino jtolentino@apache.org" />
<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">
@@ -75,8 +78,8 @@ John Tolentino jtolentino@apache.org" />
- Last Published: 2010-10-04
- | Version: 2.1
+ Last Published: 2011-06-27
+ | Version: 2.2
</div>
<div class="clear">
<hr/>
@@ -96,65 +99,65 @@ John Tolentino jtolentino@apache.org" />
<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>
- </li>
+ <strong>Perform a Release</strong>
+ </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>
@@ -182,6 +185,8 @@ John Tolentino jtolentino@apache.org" />
+
+
<li class="collapsed">
<a href="../project-info.html">Project Information</a>
@@ -219,47 +224,47 @@ John Tolentino jtolentino@apache.org" />
<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">
@@ -277,22 +282,9 @@ John Tolentino jtolentino@apache.org" />
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2>Perform a Release</h2>
-<p>Performing a release runs the following release phases:</p>
-<ul><li>Checkout from an SCM URL with optional tag</li>
-<li>Run the predefined Maven goals to release the project (by default, <tt>deploy site-deploy</tt>)</li>
-</ul>
-<p>To perform a release execute this command:</p>
-<div class="source"><pre>mvn release:perform</pre>
-</div>
-<p>This relies on <tt>release.properties</tt> being present from a previous release preparation. If this is not the case, you need to give the goal the name of the URL and optional tag to perform the release from. For example:</p>
-<div class="source"><pre>mvn release:perform -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0</pre>
-</div>
-<p><tt>release:perform</tt> will fork a new Maven instance to build the checked-out project. This new Maven instance will use the same system configuration and Maven profiles used by the one running the <tt>release:perform</tt> goal.</p>
-<p>It is possible to force some profiles to get enabled during release (for example to enable time-consummung tasks that are only relevant at release-time) by setting a comma separated list of profiles names in the <tt>releaseProfiles</tt> parameter. The goals and profiles required to release the project can then be configured in the POM:</p>
-<div class="source"><pre> <plugin>
+ <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License. You may obtain a copy of the License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section"><h2>Perform a Release<a name="Perform_a_Release"></a></h2><p>Performing a relea
se runs the following release phases:</p><ul><li>Checkout from an SCM URL with optional tag</li><li>Run the predefined Maven goals to release the project (by default, <tt>deploy site-deploy</tt>)</li></ul><p>To perform a release execute this command:</p><div><pre>mvn release:perform</pre></div><p>This relies on <tt>release.properties</tt> being present from a previous release preparation. If this is not the case, you need to give the goal the name of the URL and optional tag to perform the release from. For example:</p><div><pre>mvn release:perform -DconnectionUrl=scm:svn:https://svn.apache.org/repos/asf/maven/plugins/tags/maven-release-plugin-2.0</pre></div><p><tt>release:perform</tt> will fork a new Maven instance to build the checked-out project. This new Maven instance will use the same system configuration and Maven profiles used by the one running the <tt>release:perform</tt> goal.</p><p>It is possible to force some profiles to get enabled during release (for example t
o enable time-consummung tasks that are only relevant at release-time) by setting a comma separated list of profiles names in the <tt>releaseProfiles</tt> parameter. The goals and profiles required to release the project can then be configured in the POM:</p><div><pre> <plugin>
<artifactId>maven-release-plugin</artifactId>
- <version>2.1</version>
+ <version>2.2</version>
<configuration>
<!--
During release:perform, enable the "release" profile
@@ -300,11 +292,7 @@ John Tolentino jtolentino@apache.org" />
<releaseProfiles>release</releaseProfiles>
<goals>deploy assembly:assembly</goals>
</configuration>
- </plugin></pre>
-</div>
-<p>After the release is complete, the <tt>release.properties</tt> and other release files will be removed from the checkout.</p>
-</div>
-
+ </plugin></pre></div><p>After the release is complete, the <tt>release.properties</tt> and other release files will be removed from the checkout.</p></div>
</div>
</div>
<div class="clear">
@@ -312,7 +300,7 @@ John Tolentino jtolentino@apache.org" />
</div>
<div id="footer">
<div class="xright">©
- 2002-2010
+ 2002-2011
The Apache Software Foundation
Modified: websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/prepare-release.html
==============================================================================
--- websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/prepare-release.html (original)
+++ websites/production/maventest/content/plugins/maven-release-plugin-latest/examples/prepare-release.html Tue May 8 11:38:11 2012
@@ -12,7 +12,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
- <title>Maven Release plugin - Prepare a Release</title>
+ <title>Prepare a Release</title>
<style type="text/css" media="all">
@import url("../css/maven-base.css");
@import url("../css/maven-theme.css");
@@ -32,16 +32,16 @@ Dennis Lundberg dennisl@apache.org" />
</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>
@@ -60,13 +60,16 @@ Dennis Lundberg dennisl@apache.org" />
<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">
@@ -76,8 +79,8 @@ Dennis Lundberg dennisl@apache.org" />
- Last Published: 2010-10-04
- | Version: 2.1
+ Last Published: 2011-06-27
+ | Version: 2.2
</div>
<div class="clear">
<hr/>
@@ -97,65 +100,65 @@ Dennis Lundberg dennisl@apache.org" />
<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>
- </li>
+ <strong>Prepare a Release</strong>
+ </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>
@@ -183,6 +186,8 @@ Dennis Lundberg dennisl@apache.org" />
+
+
<li class="collapsed">
<a href="../project-info.html">Project Information</a>
@@ -220,47 +225,47 @@ Dennis Lundberg dennisl@apache.org" />
<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">
@@ -278,40 +283,26 @@ Dennis Lundberg dennisl@apache.org" />
</div>
<div id="bodyColumn">
<div id="contentBox">
- <div class="section"><h2>Prepare a Release</h2>
-<p>Preparing a release goes through the following release phases:</p>
-<ul><li>Check that there are no uncommitted changes in the sources</li>
-<li>Check that there are no SNAPSHOT dependencies</li>
-<li>Change the version in the POMs from x-SNAPSHOT to a new version (you will be prompted for the versions to use)</li>
-<li>Transform the SCM information in the POM to include the final destination of the tag</li>
-<li>Run the project tests against the modified POMs to confirm everything is in working order</li>
-<li>Commit the modified POMs</li>
-<li>Tag the code in the SCM with a version name (this will be prompted for)</li>
-<li>Bump the version in the POMs to a new value y-SNAPSHOT (these values will also be prompted for)</li>
-<li>Commit the modified POMs</li>
-</ul>
-<p>To prepare a release execute this command:</p>
-<div class="source"><pre>mvn release:prepare</pre>
-</div>
-<p><b>Note:</b> If an error occurs, or the process is cancelled, then running this command again will pick up from where the last one left off.</p>
-<p>If you wish to start again, use:</p>
-<div class="source"><pre>mvn release:prepare -Dresume=false</pre>
-</div>
-<p>Alternatively, you can use:</p>
-<div class="source"><pre>mvn release:clean release:prepare</pre>
-</div>
-<p><b>Note:</b> If any changes have been made to your source files they might need to be reverted before you restart the prepare process. You can use <tt>release:rollback</tt> to make the plugin do it for you.</p>
-<div class="section"><h3>Multi-module projects</h3>
-<p>You will be prompted for the version number for each module of the project. If you prefer that every module gets the same version as the parent POM, you can set the option <tt>autoVersionSubmodules</tt> to <tt>true</tt>. Now you will be asked only once for the release version and the next development version.</p>
-</div>
-<div class="section"><h3>Generating release POMs</h3>
-<p>It is possible to generate a <tt>release-pom.xml</tt> file for each project that contains the fully resolved project used at release time as a record for later. As of the 2.0 release, this requires calling an alternate goal:</p>
-<div class="source"><pre>mvn release:prepare-with-pom</pre>
-</div>
-<p>This goal is equivalent to the <tt>release:prepare</tt> goal, except that it requires a previous build of the project to exist to properly populate the <tt>release-pom.xml</tt> files.</p>
-</div>
-</div>
-
+ <!-- Licensed to the Apache Software Foundation (ASF) under one --><!-- or more contributor license agreements. See the NOTICE file --><!-- distributed with this work for additional information --><!-- regarding copyright ownership. The ASF licenses this file --><!-- to you under the Apache License, Version 2.0 (the --><!-- "License"); you may not use this file except in compliance --><!-- with the License. You may obtain a copy of the License at --><!-- --><!-- http://www.apache.org/licenses/LICENSE-2.0 --><!-- --><!-- Unless required by applicable law or agreed to in writing, --><!-- software distributed under the License is distributed on an --><!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY --><!-- KIND, either express or implied. See the License for the --><!-- specific language governing permissions and limitations --><!-- under the License. --><div class="section"><h2>Prepare a Release<a name="Prepare_a_Release"></a></h2><p>Preparing a releas
e goes through the following release phases:</p><ul><li>Check that there are no uncommitted changes in the sources</li><li>Check that there are no SNAPSHOT dependencies</li><li>Change the version in the POMs from x-SNAPSHOT to a new version (you will be prompted for the versions to use)</li><li>Transform the SCM information in the POM to include the final destination of the tag</li><li>Run the project tests against the modified POMs to confirm everything is in working order</li><li>Commit the modified POMs</li><li>Tag the code in the SCM with a version name (this will be prompted for)</li><li>Bump the version in the POMs to a new value y-SNAPSHOT (these values will also be prompted for)</li><li>Commit the modified POMs</li></ul><p>To prepare a release execute this command:</p><div><pre>mvn release:prepare</pre></div><p><b>Note:</b> If an error occurs, or the process is cancelled, then running this command again will pick up from where the last one left off.</p><p>If you wish
to start again, use:</p><div><pre>mvn release:prepare -Dresume=false</pre></div><p>Alternatively, you can use:</p><div><pre>mvn release:clean release:prepare</pre></div><p><b>Note:</b> If any changes have been made to your source files they might need to be reverted before you restart the prepare process. You can use <tt>release:rollback</tt> to make the plugin do it for you.</p><div class="section"><h3>Multi-module projects<a name="Multi-module_projects"></a></h3><p>You will be prompted for the version number for each module of the project. If you prefer that every module gets the same version as the parent POM, you can set the option <tt>autoVersionSubmodules</tt> to <tt>true</tt>. Now you will be asked only once for the release version and the next development version.</p></div><div class="section"><h3>Generating release POMs<a name="Generating_release_POMs"></a></h3><p>It is possible to generate a <tt>release-pom.xml</tt> file for each project that contains the fully re
solved project used at release time as a record for later. As of the 2.0 release, this requires calling an alternate goal:</p><div><pre>mvn release:prepare-with-pom</pre></div><p>This goal is equivalent to the <tt>release:prepare</tt> goal, except that it requires a previous build of the project to exist to properly populate the <tt>release-pom.xml</tt> files.</p></div><div class="section"><h3>Overriding the default tag name format<a name="Overriding_the_default_tag_name_format"></a></h3><p>By default, if you do not specify a tag name, a default tag name of <tt>artifactId</tt>-<tt>version</tt> will be suggested (and if running non-interactively used).</p><p>You can specify the exact tag name to use from the command line by passing the <tt>tag</tt> property, but if you want to have the tag name generated, but just change the default pattern, you can use the <tt>tagNameFormat</tt> configuration option.</p><p>For example to have the tag name default to the version number prefix
ed with a <tt>v</tt> you could configure your pom like so:</p><div class="source"><pre><project>
+ [...]
+ <build>
+ [...]
+ <plugins>
+ [...]
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-release-plugin</artifactId>
+ <version>2.2</version>
+ <configuration>
+ <tagNameFormat>v@{project.version}</tagNameFormat>
+ </configuration>
+ </plugin>
+ [...]
+ </plugins>
+ [...]
+ </build>
+ [...]
+</project></pre></div><p>The tagNameFormat uses <tt>@{</tt> and <tt>}</tt> as delimiters in order to ensure that the default Maven property interpolation does not substitute the values before the version transformation has taken place.</p><p>The following properties are supported:</p><ul><li><tt>project.groupId</tt> which corresponds to the project's groupId.</li><li><tt>project.artifactId</tt> which corresponds to the project's artifactId.</li><li><tt>project.version</tt> which corresponds to the project's release version.</li></ul><p>The <tt>project.</tt> prefix is optional and may be omitted.</p></div></div>
</div>
</div>
<div class="clear">
@@ -319,7 +310,7 @@ Dennis Lundberg dennisl@apache.org" />
</div>
<div id="footer">
<div class="xright">©
- 2002-2010
+ 2002-2011
The Apache Software Foundation