You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by be...@apache.org on 2008/07/24 13:35:14 UTC

svn commit: r679364 - /maven/plugins/trunk/maven-invoker-plugin/src/site/apt/examples/fast-use.apt

Author: bentmann
Date: Thu Jul 24 04:35:13 2008
New Revision: 679364

URL: http://svn.apache.org/viewvc?rev=679364&view=rev
Log:
o Pointed out requirement to sync remote repo identifiers with identifier of local testing repo

Modified:
    maven/plugins/trunk/maven-invoker-plugin/src/site/apt/examples/fast-use.apt

Modified: maven/plugins/trunk/maven-invoker-plugin/src/site/apt/examples/fast-use.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-invoker-plugin/src/site/apt/examples/fast-use.apt?rev=679364&r1=679363&r2=679364&view=diff
==============================================================================
--- maven/plugins/trunk/maven-invoker-plugin/src/site/apt/examples/fast-use.apt (original)
+++ maven/plugins/trunk/maven-invoker-plugin/src/site/apt/examples/fast-use.apt Thu Jul 24 04:35:13 2008
@@ -28,7 +28,7 @@
       <plugin>
         <groupId>org.apache.maven.plugins</groupId>
         <artifactId>maven-invoker-plugin</artifactId>
-        <version>1.2</version>
+        <version>1.3</version>
         <configuration>
           ...
           <settingsFile>src/it/settings.xml</settingsFile>
@@ -41,7 +41,8 @@
 </project>
 -------------------
 
-  The settings must contain the following content:
+  The settings must contain the following content which effectively tells Maven to use the local repository as a remote
+  repository:
   
 -------------------
 <?xml version="1.0"?>
@@ -54,7 +55,7 @@
       </activation>
       <repositories>
         <repository>
-          <id>local.central</id>
+          <id>local</id>
           <url>file://@localRepository@</url>
           <releases>
             <enabled>true</enabled>
@@ -66,7 +67,7 @@
       </repositories>
       <pluginRepositories>
         <pluginRepository>
-          <id>local.central</id>
+          <id>local</id>
           <url>file://@localRepository@</url>
           <releases>
             <enabled>true</enabled>
@@ -80,4 +81,14 @@
   </profiles>
 </settings>
 -------------------  
-  
+
+  The token <<<@localRepository@>>> will be automatically replaced by the Invoker Plugin with the path to the local
+  repository used for the Maven invocation.
+
+  <<Warning:>> It is important to use the identifier "local" for the repositories. Otherwise, it is possible that Maven
+  downloads artifacts from an external repository instead of using the artifacts that have just been installed into the
+  testing repository. This imposes the risk of running the integration tests with outdated (snapshot) artifacts. The
+  reason for this is the way the repository metadata files are named: <<<maven-metadata-\<id\>.xml>>>. During staging
+  of the test artifacts into the local repository, <<<maven-metadata-local.xml>>> files will be created. If the
+  identifier "foo" would be used for the remote repository in the <<<settings.xml>>>, Maven would look for metadata in
+  <<<maven-metadata-foo.xml>>> and would as such miss the already existing metadata.