You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by de...@apache.org on 2008/08/02 13:48:37 UTC
svn commit: r681958 -
/maven/shared/trunk/maven-invoker/src/site/apt/usage.apt
Author: dennisl
Date: Sat Aug 2 04:48:37 2008
New Revision: 681958
URL: http://svn.apache.org/viewvc?rev=681958&view=rev
Log:
o Move the section about "Configuring the Maven Home Directory" to after the code examples.
Modified:
maven/shared/trunk/maven-invoker/src/site/apt/usage.apt
Modified: maven/shared/trunk/maven-invoker/src/site/apt/usage.apt
URL: http://svn.apache.org/viewvc/maven/shared/trunk/maven-invoker/src/site/apt/usage.apt?rev=681958&r1=681957&r2=681958&view=diff
==============================================================================
--- maven/shared/trunk/maven-invoker/src/site/apt/usage.apt (original)
+++ maven/shared/trunk/maven-invoker/src/site/apt/usage.apt Sat Aug 2 04:48:37 2008
@@ -50,41 +50,6 @@
for the project defined at <<</path/to/pom.xml>>>. If the build fails, we will
remain blissfully ignorant...
-* Configuring the Maven Home Directory
-
- You can use the method <<<Invoker.setMavenHome()>>> to specify which Maven executable it should use.
- If you don't provide an explicit value for this setting, the <<<Invoker>>> will automatically try to detect
- a Maven installation by evaluating the system property <<<maven.home>>> and the environment variable <<<M2_HOME>>>.
-
- <<Note:>> If you use the invocation API in tests run by the {{{../../plugins/maven-surefire-plugin}Maven Surefire Plugin}},
- you need to tell Surefire to pass the system property <<<maven.home>>> to the tests in order for the automatic Maven
- detection to work:
-
-+---+
-<project>
- ...
- <build>
- <plugins>
- <plugin>
- <groupId>org.apache.maven.plugins</groupId>
- <artifactId>maven-surefire-plugin</artifactId>
- <version>2.4.3</version>
- <configuration>
- <systemProperties>
- <property>
- <name>maven.home</name>
- <value>${maven.home}</value>
- </property>
- </systemProperties>
- </configuration>
- </plugin>
- </plugins>
- ...
- </build>
- ...
-</project>
-+---+
-
* Checking the Exit Code
If we wanted to detect a build failure in the above example, we could simply
@@ -160,4 +125,39 @@
of goals per build. We can actually accommodate a fairly complex configuration
of the Invoker without adding complexity to the <<<publishSite>>> method in this manner.
+* Configuring the Maven Home Directory
+
+ You can use the method <<<Invoker.setMavenHome()>>> to specify which Maven executable it should use.
+ If you don't provide an explicit value for this setting, the <<<Invoker>>> will automatically try to detect
+ a Maven installation by evaluating the system property <<<maven.home>>> and the environment variable <<<M2_HOME>>>.
+
+ <<Note:>> If you use the invocation API in tests run by the {{{../../plugins/maven-surefire-plugin}Maven Surefire Plugin}},
+ you need to tell Surefire to pass the system property <<<maven.home>>> to the tests in order for the automatic Maven
+ detection to work:
+
++---+
+<project>
+ ...
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <version>2.4.3</version>
+ <configuration>
+ <systemProperties>
+ <property>
+ <name>maven.home</name>
+ <value>${maven.home}</value>
+ </property>
+ </systemProperties>
+ </configuration>
+ </plugin>
+ </plugins>
+ ...
+ </build>
+ ...
+</project>
++---+
+