You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by kh...@apache.org on 2014/06/27 22:45:21 UTC
svn commit: r914157 [11/36] - in
/websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST:
./ apidocs/ apidocs/org/ apidocs/org/apache/ apidocs/org/apache/maven/
apidocs/org/apache/maven/plugin/ apidocs/org/apache/maven/plugin/in...
Added: websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/fast-use.html
==============================================================================
--- websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/fast-use.html (added)
+++ websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/fast-use.html Fri Jun 27 20:45:16 2014
@@ -0,0 +1,284 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at 2014-06-27
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Apache Maven Invoker Plugin - Fast Build Configuration</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Olivier Lamy" />
+ <meta name="Date-Creation-yyyymmdd" content="20080802" />
+ <meta name="Date-Revision-yyyymmdd" content="20140627" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../../../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../../../index.html">Maven</a>
+ >
+ <a href="../../index.html">Plugins</a>
+ >
+ <a href="../">Apache Maven Invoker Plugin</a>
+ >
+ Fast Build Configuration
+ </div>
+ <div class="xright">
+ Last Published: 2014-06-27
+ | Version: 1.8.1
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink">License</a>
+ </li>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ </ul>
+ <h5>reference</h5>
+ <ul>
+ <li class="none">
+ <a href="../build-job.html">build-job.xml</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/access-test-classes.html">Accessing Test Classes</a>
+ </li>
+ <li class="none">
+ <a href="../examples/clone-projects.html">Cloning Projects</a>
+ </li>
+ <li class="none">
+ <a href="../examples/filtering.html">Filtering Files</a>
+ </li>
+ <li class="none">
+ <strong>Fast Build Configuration</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/install-artifacts.html">Installing Artifacts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/invoker-properties.html">Invoker Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-conditions.html">Selector Conditions</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-scripts.html">Selector Scripts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/post-build-script.html">Using a Post Build Script</a>
+ </li>
+ <li class="none">
+ <a href="../examples/prepare-build-env.html">Preparing the Build Environment</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping.html">Skipping Invocations</a>
+ </li>
+ <li class="none">
+ <a href="../examples/integration-test-verify.html">Using with other integration test frameworks</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../project-reports.html">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- 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/references/apt-
format.html --><div class="section">
+<h2>Fast Build Configuration<a name="Fast_Build_Configuration"></a></h2>
+<p>If you follow the recommended approach and use a dedicated local repository for the integration tests (e.g. <tt>target/local-repo</tt>), you will likely encounter long build times. If the test repository has been cleaned, the plugin needs to re-download all artifacts from the central repo and the resulting network traffic slows the test execution down.</p>
+<p>But you can configure the plugin to download released artifacts from your local repo. <i>Note:</i> This will work without optional settings with Maven >= 2.0.9 because many plugins versions are locked in the super POM. For older versions, you have to lock plugins versions.</p>
+<p>To enable this feature, you have to add a <tt>settings.xml</tt> file in your project (for example in <tt>src/it/settings.xml</tt>) and modify the plugin configuration as this: </p>
+<div class="source">
+<pre><project>
+ ...
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-invoker-plugin</artifactId>
+ <version>1.8.1</version>
+ <configuration>
+ ...
+ <settingsFile>src/it/settings.xml</settingsFile>
+ ...
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ ...
+</project></pre></div>
+<p>The settings must contain the following content which effectively tells Maven to use the local repository as a remote repository:</p>
+<div class="source">
+<pre><?xml version="1.0"?>
+<settings>
+ <profiles>
+ <profile>
+ <id>it-repo</id>
+ <activation>
+ <activeByDefault>true</activeByDefault>
+ </activation>
+ <repositories>
+ <repository>
+ <id>local.central</id>
+ <url>@localRepositoryUrl@</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </repository>
+ </repositories>
+ <pluginRepositories>
+ <pluginRepository>
+ <id>local.central</id>
+ <url>@localRepositoryUrl@</url>
+ <releases>
+ <enabled>true</enabled>
+ </releases>
+ <snapshots>
+ <enabled>true</enabled>
+ </snapshots>
+ </pluginRepository>
+ </pluginRepositories>
+ </profile>
+ </profiles>
+</settings></pre></div>
+<p>The token <tt>@localRepositoryUrl@</tt> will be automatically replaced by the Invoker Plugin with the URL to the local repository used for the Maven invocation.</p></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2014
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
\ No newline at end of file
Added: websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/filtering.html
==============================================================================
--- websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/filtering.html (added)
+++ websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/filtering.html Fri Jun 27 20:45:16 2014
@@ -0,0 +1,308 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at 2014-06-27
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Apache Maven Invoker Plugin - Filtering Files</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Benjamin Bentmann" />
+ <meta name="Date-Creation-yyyymmdd" content="20080830" />
+ <meta name="Date-Revision-yyyymmdd" content="20140627" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../../../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../../../index.html">Maven</a>
+ >
+ <a href="../../index.html">Plugins</a>
+ >
+ <a href="../">Apache Maven Invoker Plugin</a>
+ >
+ Filtering Files
+ </div>
+ <div class="xright">
+ Last Published: 2014-06-27
+ | Version: 1.8.1
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink">License</a>
+ </li>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ </ul>
+ <h5>reference</h5>
+ <ul>
+ <li class="none">
+ <a href="../build-job.html">build-job.xml</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/access-test-classes.html">Accessing Test Classes</a>
+ </li>
+ <li class="none">
+ <a href="../examples/clone-projects.html">Cloning Projects</a>
+ </li>
+ <li class="none">
+ <strong>Filtering Files</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/fast-use.html">Fast Build Configuration</a>
+ </li>
+ <li class="none">
+ <a href="../examples/install-artifacts.html">Installing Artifacts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/invoker-properties.html">Invoker Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-conditions.html">Selector Conditions</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-scripts.html">Selector Scripts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/post-build-script.html">Using a Post Build Script</a>
+ </li>
+ <li class="none">
+ <a href="../examples/prepare-build-env.html">Preparing the Build Environment</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping.html">Skipping Invocations</a>
+ </li>
+ <li class="none">
+ <a href="../examples/integration-test-verify.html">Using with other integration test frameworks</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../project-reports.html">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- 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/references/apt-
format.html --><div class="section">
+<h2>Filtering Files<a name="Filtering_Files"></a></h2>
+<p>Some files of the sub projects can be filtered, i.e. special tokens will be replaced by some other string before the actual build is started. In detail, the following files will be filtered:</p>
+<ul>
+<li>POM files selected by the include/exclude patterns. The tokens to be filtered must be enclosed in <tt>@...@</tt> to avoid interferences with Maven's normal POM interpolation, i.e. use <tt>@project.version@</tt> instead of <tt>${project.version}</tt>. Starting with version 1.3, the plugin will also (recursively) filter all POM files referenced via <tt><parent></tt> or <tt><module></tt> tags, if the projects are cloned to a temporary location.</li>
+<li>The custom user setting file. Again, the tokens to be filtered in this file must be enclosed in <tt>@...@</tt>.</li>
+<li>The invoker properties, the goals file and the profiles file. Tokens in these files must use the usual Maven syntax <tt>${...}</tt>.</li></ul>
+<p>The following example directory structure highlights the files which are filtered by the Invoker Plugin:</p>
+<div class="source">
+<pre>./
++- pom.xml
++- src/
+ +- it/
+ +- settings.xml <- Filtered
+ +- aggregator-project/
+ +- child-module-1/
+ | +- pom.xml <- Filtered
+ +- child-module-2/
+ | +- pom.xml <- Filtered
+ +- pom.xml <- Filtered
+ +- invoker.properties <- Filtered
+ +- goals.txt <- Filtered
+ +- profiles.txt <- Filtered</pre></div>
+<p>Below is the corresponding POM snippet for the plugin configuration:</p>
+<div class="source">
+<pre><project>
+ <properties>
+ <projectPropertyUsedForFiltering>another-value</projectPropertyUsedForFiltering>
+ </properties>
+ ...
+ <build>
+ <plugins>
+ <plugin>
+ <artifactId>maven-invoker-plugin</artifactId>
+ <version>1.8.1</version>
+ <configuration>
+ <projectsDirectory>src/it</projectsDirectory>
+ <cloneProjectsTo>${project.build.directory}/it</cloneProjectsTo>
+ <pomIncludes>
+ <pomInclude>*/pom.xml</pomInclude>
+ </pomIncludes>
+ <settingsFile>src/it/settings.xml</settingsFile>
+ <filterProperties>
+ <pluginPropertyUsedForFiltering>some-value</pluginPropertyUsedForFiltering>
+ </filterProperties>
+ </configuration>
+ <executions>
+ <execution>
+ <id>integration-test</id>
+ <goals>
+ <goal>run</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+</project></pre></div>
+<p>When filtering the files, the plugin searches various data sources for a token's replacement value in the order indicated below. The search terminates as soon as an existing replacement value has been found, i.e. the value is not <tt>null</tt>.</p>
+<ol style="list-style-type: decimal">
+<li>Tokens of the form <tt>project.*</tt> and <tt>pom.*</tt> will be expanded to the referenced POM value if possible, e.g. <tt>project.version</tt> refers to the version given in the <tt>pom.xml</tt> that executed the Invoker Plugin. If no such POM element exists, the value lookup continues as outlined next.</li>
+<li>Built-in properties defined by the Invoker Plugin will be processed. See this table for a list of available built-in properties:
+<table border="1" class="bodyTable">
+<tr class="a">
+<th align="left">Built-in Property</th>
+<th align="left">Value</th>
+<th align="left">Since</th></tr>
+<tr class="b">
+<td align="left"><tt>basedir</tt></td>
+<td align="left">The absolute path to the project base directory of the main build.</td>
+<td align="left">1.1</td></tr>
+<tr class="a">
+<td align="left"><tt>baseurl</tt></td>
+<td align="left">The <tt>file:</tt> URL to the project base directory of the main build.</td>
+<td align="left">1.4</td></tr>
+<tr class="b">
+<td align="left"><tt>localRepository</tt></td>
+<td align="left">The absolute path to the local repository used for the main build.</td>
+<td align="left">1.2</td></tr>
+<tr class="a">
+<td align="left"><tt>localRepositoryUrl</tt></td>
+<td align="left">The <tt>file:</tt> URL to the local repository used for the main build.</td>
+<td align="left">1.3</td></tr></table></li>
+<li>The properties given by the parameter <tt>filterProperties</tt> in the plugin configuration will be consulted for a property whose key equals the token. For the example POM shown above, the value <tt>some-value</tt> has been associated with the token <tt>pluginPropertyUsedForFiltering</tt>.</li>
+<li>The properties given by the POM's <tt><properties></tt> section will be searched for a property whose key equals the token. Regarding the example POM, the value <tt>another-value</tt> has been associated with the token <tt>projectPropertyUsedForFiltering</tt>.</li></ol>
+<p>Tokens for which no replacement value could be determined will be left unchanged.</p></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2014
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
\ No newline at end of file
Added: websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/install-artifacts.html
==============================================================================
--- websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/install-artifacts.html (added)
+++ websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/install-artifacts.html Fri Jun 27 20:45:16 2014
@@ -0,0 +1,251 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at 2014-06-27
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Apache Maven Invoker Plugin - Installing Artifacts</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Paul Gier" />
+ <meta name="Date-Creation-yyyymmdd" content="20080802" />
+ <meta name="Date-Revision-yyyymmdd" content="20140627" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../../../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../../../index.html">Maven</a>
+ >
+ <a href="../../index.html">Plugins</a>
+ >
+ <a href="../">Apache Maven Invoker Plugin</a>
+ >
+ Installing Artifacts
+ </div>
+ <div class="xright">
+ Last Published: 2014-06-27
+ | Version: 1.8.1
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink">License</a>
+ </li>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ </ul>
+ <h5>reference</h5>
+ <ul>
+ <li class="none">
+ <a href="../build-job.html">build-job.xml</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/access-test-classes.html">Accessing Test Classes</a>
+ </li>
+ <li class="none">
+ <a href="../examples/clone-projects.html">Cloning Projects</a>
+ </li>
+ <li class="none">
+ <a href="../examples/filtering.html">Filtering Files</a>
+ </li>
+ <li class="none">
+ <a href="../examples/fast-use.html">Fast Build Configuration</a>
+ </li>
+ <li class="none">
+ <strong>Installing Artifacts</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/invoker-properties.html">Invoker Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-conditions.html">Selector Conditions</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-scripts.html">Selector Scripts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/post-build-script.html">Using a Post Build Script</a>
+ </li>
+ <li class="none">
+ <a href="../examples/prepare-build-env.html">Preparing the Build Environment</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping.html">Skipping Invocations</a>
+ </li>
+ <li class="none">
+ <a href="../examples/integration-test-verify.html">Using with other integration test frameworks</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../project-reports.html">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- 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/references/apt-
format.html --><div class="section">
+<h2>Installing Artifacts<a name="Installing_Artifacts"></a></h2>
+<p>The following example shows a plugin configuration using the <tt><a href="../install-mojo.html">invoker:install</a></tt> goal. This will cause the project artifact(s) to be installed to a dedicated local repository before executing the projects. This can be helpful if you want to build your project and test the new artifact(s) in a single step instead of installing first and then running tests.</p>
+<div class="source">
+<pre><project>
+ ...
+ <build>
+ <plugins>
+ <plugin>
+ <artifactId>maven-invoker-plugin</artifactId>
+ <version>1.8.1</version>
+ <configuration>
+ <projectsDirectory>src/it</projectsDirectory>
+ <localRepositoryPath>target/local-repo</localRepositoryPath>
+ </configuration>
+ <executions>
+ <execution>
+ <id>integration-test</id>
+ <goals>
+ <goal>install</goal>
+ <goal>run</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+ ...
+</project></pre></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2014
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
\ No newline at end of file
Added: websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/integration-test-verify.html
==============================================================================
--- websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/integration-test-verify.html (added)
+++ websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/integration-test-verify.html Fri Jun 27 20:45:16 2014
@@ -0,0 +1,246 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at 2014-06-27
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Apache Maven Invoker Plugin - Using with other integration test frameworks</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Stephen Connolly" />
+ <meta name="Date-Creation-yyyymmdd" content="20090815" />
+ <meta name="Date-Revision-yyyymmdd" content="20140627" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../../../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../../../index.html">Maven</a>
+ >
+ <a href="../../index.html">Plugins</a>
+ >
+ <a href="../">Apache Maven Invoker Plugin</a>
+ >
+ Using with other integration test frameworks
+ </div>
+ <div class="xright">
+ Last Published: 2014-06-27
+ | Version: 1.8.1
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink">License</a>
+ </li>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ </ul>
+ <h5>reference</h5>
+ <ul>
+ <li class="none">
+ <a href="../build-job.html">build-job.xml</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/access-test-classes.html">Accessing Test Classes</a>
+ </li>
+ <li class="none">
+ <a href="../examples/clone-projects.html">Cloning Projects</a>
+ </li>
+ <li class="none">
+ <a href="../examples/filtering.html">Filtering Files</a>
+ </li>
+ <li class="none">
+ <a href="../examples/fast-use.html">Fast Build Configuration</a>
+ </li>
+ <li class="none">
+ <a href="../examples/install-artifacts.html">Installing Artifacts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/invoker-properties.html">Invoker Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-conditions.html">Selector Conditions</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-scripts.html">Selector Scripts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/post-build-script.html">Using a Post Build Script</a>
+ </li>
+ <li class="none">
+ <a href="../examples/prepare-build-env.html">Preparing the Build Environment</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping.html">Skipping Invocations</a>
+ </li>
+ <li class="none">
+ <strong>Using with other integration test frameworks</strong>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../project-reports.html">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- 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/references/apt-
format.html --><div class="section">
+<h2>Using with other integration test frameworks<a name="Using_with_other_integration_test_frameworks"></a></h2>
+<p>If you are using other integration test frameworks, or if you need to setup an integration test enviroment prior to test execution and tear that envronment down afterwards, then you need to use the <tt>invoker:integration-test</tt> and <tt>invoker:verify</tt> goals in place of <tt>invoker:run</tt>. For example:</p>
+<div class="source">
+<pre><project>
+ <build>
+ <plugins>
+ <plugin>
+ <artifactId>maven-invoker-plugin</artifactId>
+ <version>1.8.1</version>
+ <executions>
+ <execution>
+ <id>integration-test</id>
+ <goals>
+ <goal>integration-test</goal>
+ <goal>verify</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+</project></pre></div>
+<p>This will allow any plugins bound to the <tt>post-integration-test</tt> phase to execute before the <tt>verify</tt> phase executes the <tt>invoker:verify</tt> goal that we have just bound.</p></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2014
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
\ No newline at end of file
Added: websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/invoker-properties.html
==============================================================================
--- websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/invoker-properties.html (added)
+++ websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/invoker-properties.html Fri Jun 27 20:45:16 2014
@@ -0,0 +1,249 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at 2014-06-27
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Apache Maven Invoker Plugin - Invoker Properties</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Benjamin Bentmann" />
+ <meta name="Date-Creation-yyyymmdd" content="20080809" />
+ <meta name="Date-Revision-yyyymmdd" content="20140627" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../../../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../../../index.html">Maven</a>
+ >
+ <a href="../../index.html">Plugins</a>
+ >
+ <a href="../">Apache Maven Invoker Plugin</a>
+ >
+ Invoker Properties
+ </div>
+ <div class="xright">
+ Last Published: 2014-06-27
+ | Version: 1.8.1
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink">License</a>
+ </li>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ </ul>
+ <h5>reference</h5>
+ <ul>
+ <li class="none">
+ <a href="../build-job.html">build-job.xml</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/access-test-classes.html">Accessing Test Classes</a>
+ </li>
+ <li class="none">
+ <a href="../examples/clone-projects.html">Cloning Projects</a>
+ </li>
+ <li class="none">
+ <a href="../examples/filtering.html">Filtering Files</a>
+ </li>
+ <li class="none">
+ <a href="../examples/fast-use.html">Fast Build Configuration</a>
+ </li>
+ <li class="none">
+ <a href="../examples/install-artifacts.html">Installing Artifacts</a>
+ </li>
+ <li class="none">
+ <strong>Invoker Properties</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-conditions.html">Selector Conditions</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-scripts.html">Selector Scripts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/post-build-script.html">Using a Post Build Script</a>
+ </li>
+ <li class="none">
+ <a href="../examples/prepare-build-env.html">Preparing the Build Environment</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping.html">Skipping Invocations</a>
+ </li>
+ <li class="none">
+ <a href="../examples/integration-test-verify.html">Using with other integration test frameworks</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../project-reports.html">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- 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/references/apt-
format.html --><div class="section">
+<h2>Invoker Properties<a name="Invoker_Properties"></a></h2>
+<p>The various parameters in the plugin configuration provide a means to globally configure the goals, profiles etc. used to run a Maven build on the projects. However, for certain projects you might want to specify different settings. To avoid the hassle of multiple plugin executions, you can simply use a file named <tt>invoker.properties</tt> to control the build settings on a per project basis. The exact name of this properties file is configurable but it needs to reside in the base directory of the respective project as shown below:</p>
+<div class="source">
+<pre>./
++- src/
+ +- it/
+ +- test-project/
+ +- pom.xml
+ +- invoker.properties
+ +- src/</pre></div>
+<p>There are only a few keys supported in this file and their names typically match the corresponding parameters in the plugin configuration. For a complete overview of supported properties, see the example given in the documentation of the plugin parameter <tt><a href="../run-mojo.html#invokerPropertiesFile">invokerPropertiesFile</a></tt>.</p>
+<p>The comments given in the example should be rather self-explanatory. Looking closely, you can also notice that the syntax <tt>${expression}</tt> can be used to filter the property values. What deserves some more description is the possibility to perform several Maven builds on the same project. By default, the Invoker Plugin will perform the following steps for each project:</p>
+<ul>
+<li>Run the pre build hook script if existent</li>
+<li>Invoke Maven in the project directory</li>
+<li>Run the post build hook script if existent</li></ul>
+<p>Since plugin version 1.3, you can append a one-based index to the invoker properties in order to enable/configure further invocations of Maven. More precisely, <tt>invoker.goals.1</tt> specifies the goals for the first build, <tt>invoker.goals.2</tt> lists the goals for the second build and so on. These builds will be performed one after the other:</p>
+<ul>
+<li>Run the pre build hook script if existent</li>
+<li>Invoke Maven in the project directory</li>
+<li>Invoke Maven in the project directory</li>
+<li>...</li>
+<li>Invoke Maven in the project directory</li>
+<li>Run the post build hook script if existent</li></ul>
+<p>Most of the properties can be indexed this way, e.g. <tt>invoker.profiles.3</tt> would specify the profiles to use for the third invocation. If the property <tt>invoker.profiles.3</tt> was not defined, the plugin would query the property <tt>invoker.profiles</tt> as a fallback to determine the profiles for the third build. This build loop ends after invocation <i>i</i> if no property <tt>invoker.*.</tt><i>i+1</i> is defined.</p>
+<p>The invoker properties can also be used to skip projects based on the current JRE version or OS family. For more information on this feature, please see <a href="./selector-conditions.html">Selector Conditions</a>.</p></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2014
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
\ No newline at end of file
Added: websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/post-build-script.html
==============================================================================
--- websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/post-build-script.html (added)
+++ websites/production/maven/content/plugins-archives/maven-invoker-plugin-LATEST/examples/post-build-script.html Fri Jun 27 20:45:16 2014
@@ -0,0 +1,288 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ | Generated by Apache Maven Doxia at 2014-06-27
+ | Rendered using Apache Maven Stylus Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Apache Maven Invoker Plugin - Using a Post-Build Script</title>
+ <style type="text/css" media="all">
+ @import url("../css/maven-base.css");
+ @import url("../css/maven-theme.css");
+ @import url("../css/site.css");
+ </style>
+ <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+ <meta name="author" content="Paul Gier" />
+ <meta name="Date-Creation-yyyymmdd" content="20080802" />
+ <meta name="Date-Revision-yyyymmdd" content="20140627" />
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+
+<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
+
+<script type="text/javascript">_uacct = "UA-140879-1";
+ urchinTracker();</script>
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="../../../" id="bannerLeft">
+ <img src="../../../images/apache-maven-project-2.png" alt="" />
+ </a>
+ <span id="bannerRight">
+ <img src="../../../images/maven-logo-2.gif" alt="" />
+ </span>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+ <div class="xleft">
+ <a href="http://www.apache.org/" class="externalLink">Apache</a>
+ >
+ <a href="../../../index.html">Maven</a>
+ >
+ <a href="../../index.html">Plugins</a>
+ >
+ <a href="../">Apache Maven Invoker Plugin</a>
+ >
+ Using a Post-Build Script
+ </div>
+ <div class="xright">
+ Last Published: 2014-06-27
+ | Version: 1.8.1
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+ <h5>Overview</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html">Introduction</a>
+ </li>
+ <li class="none">
+ <a href="../plugin-info.html">Goals</a>
+ </li>
+ <li class="none">
+ <a href="../usage.html">Usage</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html">FAQ</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/" class="externalLink">License</a>
+ </li>
+ <li class="none">
+ <a href="../download.html">Download</a>
+ </li>
+ </ul>
+ <h5>reference</h5>
+ <ul>
+ <li class="none">
+ <a href="../build-job.html">build-job.xml</a>
+ </li>
+ </ul>
+ <h5>Examples</h5>
+ <ul>
+ <li class="none">
+ <a href="../examples/access-test-classes.html">Accessing Test Classes</a>
+ </li>
+ <li class="none">
+ <a href="../examples/clone-projects.html">Cloning Projects</a>
+ </li>
+ <li class="none">
+ <a href="../examples/filtering.html">Filtering Files</a>
+ </li>
+ <li class="none">
+ <a href="../examples/fast-use.html">Fast Build Configuration</a>
+ </li>
+ <li class="none">
+ <a href="../examples/install-artifacts.html">Installing Artifacts</a>
+ </li>
+ <li class="none">
+ <a href="../examples/invoker-properties.html">Invoker Properties</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-conditions.html">Selector Conditions</a>
+ </li>
+ <li class="none">
+ <a href="../examples/selector-scripts.html">Selector Scripts</a>
+ </li>
+ <li class="none">
+ <strong>Using a Post Build Script</strong>
+ </li>
+ <li class="none">
+ <a href="../examples/prepare-build-env.html">Preparing the Build Environment</a>
+ </li>
+ <li class="none">
+ <a href="../examples/skipping.html">Skipping Invocations</a>
+ </li>
+ <li class="none">
+ <a href="../examples/integration-test-verify.html">Using with other integration test frameworks</a>
+ </li>
+ </ul>
+ <h5>Project Documentation</h5>
+ <ul>
+ <li class="collapsed">
+ <a href="../project-info.html">Project Information</a>
+ </li>
+ <li class="collapsed">
+ <a href="../project-reports.html">Project Reports</a>
+ </li>
+ </ul>
+ <h5>Maven Projects</h5>
+ <ul>
+ <li class="none">
+ <a href="../../../ant-tasks/index.html">Ant Tasks</a>
+ </li>
+ <li class="none">
+ <a href="../../../archetype/index.html">Archetype</a>
+ </li>
+ <li class="none">
+ <a href="../../../doxia/index.html">Doxia</a>
+ </li>
+ <li class="none">
+ <a href="../../../jxr/index.html">JXR</a>
+ </li>
+ <li class="none">
+ <a href="../../../maven-1.x/index.html">Maven 1.x</a>
+ </li>
+ <li class="none">
+ <a href="../../../index.html">Maven 2 & 3</a>
+ </li>
+ <li class="none">
+ <a href="../../../pom/index.html">Parent POMs</a>
+ </li>
+ <li class="none">
+ <a href="../../index.html">Plugins</a>
+ </li>
+ <li class="none">
+ <a href="../../../plugin-tools/index.html">Plugin Tools</a>
+ </li>
+ <li class="none">
+ <a href="../../../scm/index.html">SCM</a>
+ </li>
+ <li class="none">
+ <a href="../../../shared/index.html">Shared Components</a>
+ </li>
+ <li class="none">
+ <a href="../../../skins/index.html">Skins</a>
+ </li>
+ <li class="none">
+ <a href="../../../surefire/index.html">Surefire</a>
+ </li>
+ <li class="none">
+ <a href="../../../wagon/index.html">Wagon</a>
+ </li>
+ </ul>
+ <h5>ASF</h5>
+ <ul>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/how-it-works.html" class="externalLink">How Apache Works</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/" class="externalLink">Foundation</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink">Sponsoring Apache</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/foundation/thanks.html" class="externalLink">Thanks</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img alt="Built by Maven" src="../images/logos/maven-feather.png"/>
+ </a>
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- 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/references/apt-
format.html --><div class="section">
+<h2>Using a Post-Build Script<a name="Using_a_Post-Build_Script"></a></h2>
+<p>Here is an example of how the Invoker Plugin can be used to run a set of Maven projects and then verify their output with a <a class="externalLink" href="http://www.beanshell.org/">BeanShell</a> or <a class="externalLink" href="http://groovy.codehaus.org/">Groovy</a> script. The name of the script file in this case is <tt>verify.bsh</tt>.</p>
+<div class="source">
+<pre><project>
+ <build>
+ <plugins>
+ <plugin>
+ <artifactId>maven-invoker-plugin</artifactId>
+ <version>1.8.1</version>
+ <configuration>
+ <debug>true</debug>
+ <projectsDirectory>src/it</projectsDirectory>
+ <preBuildHookScript>setup.bsh</preBuildHookScript>
+ <postBuildHookScript>verify.bsh</postBuildHookScript>
+ </configuration>
+ <executions>
+ <execution>
+ <id>integration-test</id>
+ <goals>
+ <goal>run</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+</project></pre></div>
+<p>Below is an example post-build BeanShell script (<tt>verify.bsh</tt>) that checks for the existence of a JAR file after the build has run. If the JAR file does not exist, the script throws an exception which causes the Invoker Plugin to log that the build failed. More precisely, any non-null return value which does not equal <tt>true</tt> will be interpreted as a failure condition. And of course, if the script exists abnormally due to an exception, the plugin will flag the corresponding build as a failure, too.</p>
+<div class="source">
+<pre>import java.io.*;
+
+File file = new File( basedir, "target/my-test-project-1.0-SNAPSHOT.jar" );
+if ( !file.isFile() )
+{
+ throw new FileNotFoundException( "Could not find generated JAR: " + file );
+}</pre></div>
+<p>Complementary to the post-build hook script, you can also create a pre-build hook script that will be run before the invocation of Maven. This can be used to do some preparations for the build.</p>
+<p>To allow the scripts to access some useful data about the test project, the following global variables will be defined by the Invoker Plugin before running the script:</p>
+<table border="1" class="bodyTable">
+<tr class="a">
+<th align="left">Name</th>
+<th align="left">Type</th>
+<th align="left">Description</th>
+<th align="left">Since</th></tr>
+<tr class="b">
+<td align="left"><tt>basedir</tt></td>
+<td align="left"><tt>java.io.File</tt></td>
+<td align="left">The absolute path to the base directory of the test project.</td>
+<td align="left">1.0</td></tr>
+<tr class="a">
+<td align="left"><tt>localRepositoryPath</tt></td>
+<td align="left"><tt>java.io.File</tt></td>
+<td align="left">The absolute path to the local repository used for the Maven invocation on the test project.</td>
+<td align="left">1.3</td></tr>
+<tr class="b">
+<td align="left"><tt>context</tt></td>
+<td align="left"><tt>java.util.Map</tt></td>
+<td align="left">The storage of key-value pairs used to pass data from the pre-build hook script to the post-build hook script.</td>
+<td align="left">1.4</td></tr>
+<tr class="a">
+<td align="left"><tt>mavenVersion</tt></td>
+<td align="left"><tt>java.lang.String</tt></td>
+<td align="left">The version of Maven executing on the test project.</td>
+<td align="left">1.9</td></tr></table>
+<p>Additional variables that can be accessed in the hook scripts can be defined through the <tt><a href="../run-mojo.html#scriptVariables">scriptVariables</a></tt> parameter in the Invoker Plugin's configuration.</p></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ © 2002-2014
+ The Apache Software Foundation
+
+ - <a href="http://maven.apache.org/privacy-policy.html">Privacy Policy</a>.
+ Apache Maven, Maven, Apache, the Apache feather logo, and the Apache Maven project logos are trademarks of The Apache Software Foundation.
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
\ No newline at end of file