You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by vs...@apache.org on 2006/08/11 15:19:04 UTC

svn commit: r430786 - in /maven/site/trunk/src/site/apt/guides: development/guide-plugin-snapshot-repositories.apt index.apt

Author: vsiveton
Date: Fri Aug 11 06:19:03 2006
New Revision: 430786

URL: http://svn.apache.org/viewvc?rev=430786&view=rev
Log:
[MNG-2493]: Snapshot plugin repositories should be included for reference at the Maven site
Submitted by: Baerrach bonDierne
Reviewed by: Vincent Siveton

o added with small changes (ie in agreement with http://docs.codehaus.org/display/MAVEN/Development+Procedures )

Added:
    maven/site/trunk/src/site/apt/guides/development/guide-plugin-snapshot-repositories.apt   (with props)
Modified:
    maven/site/trunk/src/site/apt/guides/index.apt

Added: maven/site/trunk/src/site/apt/guides/development/guide-plugin-snapshot-repositories.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/development/guide-plugin-snapshot-repositories.apt?rev=430786&view=auto
==============================================================================
--- maven/site/trunk/src/site/apt/guides/development/guide-plugin-snapshot-repositories.apt (added)
+++ maven/site/trunk/src/site/apt/guides/development/guide-plugin-snapshot-repositories.apt Fri Aug 11 06:19:03 2006
@@ -0,0 +1,94 @@
+ ------
+ Guide to Plugin Snapshot Repositories
+ ------
+ Maven Team
+ ------
+ 11 August 2006
+ ------
+
+Introduction
+
+  If you are trying to build a development version of a maven plugin, or you 
+  just need to trial the latest plugin code that is yet to be released, then
+  you may need to access the maven plugin snapshot repositories.
+
+Repositories
+
+  The most widely known repositories are {{{http://maven.apache.org/}Maven}} 
+  itself hosted at Apache and the {{{http://mojo.codehaus.org/}Mojo Project hosted}}
+  at CodeHaus.
+
+  Both of these sites provide snapshot versions of their plugins which are
+  available from the plugin snapshot repository.
+
+  * apache snapshots = {{http://people.apache.org/maven-snapshot-repository}}
+
+  * codehaus snapshots = {{http://snapshots.maven.codehaus.org/maven2}}
+
+How to include the plugin snapshot repositories as part of your build
+
+  You need to modify your <~/.m2/settings.xml> file to include two new profiles
+  and then when you need access to the plugin snapshots use <<<-Papache>>> or 
+  <<<-Pcodehaus>>> to enable the profiles. The profile only needs to be enabled 
+  once so that the plugins can be downloaded into you local repository.  Once 
+  in your local repository Maven can succesfully resolve the dependencies and
+  the profile no longer needs to be activated.
+
++---
+<settings>
+  ...
+    <profile>
+      <id>apache</id>
+      <repositories>
+        <repository>
+          <id>apache.snapshots</id>
+          <name>Maven Snapshots</name>
+          <url>http://people.apache.org/maven-snapshot-repository</url>
+          <releases>
+            <enabled>false</enabled>
+          </releases>
+          <snapshots>
+            <enabled>true</enabled>
+          </snapshots>
+        </repository>
+      </repositories>
+      <pluginRepositories>
+        <pluginRepository>
+          <id>apache.snapshots</id>
+          <name>Maven Plugin Snapshots</name>
+          <url>http://people.apache.org/maven-snapshot-repository</url>
+          <releases>
+            <enabled>false</enabled>
+          </releases>
+          <snapshots>
+            <enabled>true</enabled>
+          </snapshots>
+        </pluginRepository>
+      </pluginRepositories>
+    </profile>
+
+    <profile>
+      <id>codehaus</id>
+      <pluginRepositories>
+        <pluginRepository>
+          <id>codehaus.plugin.snapshots</id>
+          <name>CodeHaus Plugin Snapshots</name>
+          <url>http://snapshots.maven.codehaus.org/maven2</url>
+          <releases>
+            <enabled>false</enabled>
+          </releases>
+          <snapshots>
+            <enabled>true</enabled>
+          </snapshots>
+        </pluginRepository>
+      </pluginRepositories>
+    </profile>
+  ...
+</settings>
++---
+
+  When invoking Maven for Apache profile, do it like this:
+
++---
+mvn -Papache <phase|goal>
++---

Propchange: maven/site/trunk/src/site/apt/guides/development/guide-plugin-snapshot-repositories.apt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: maven/site/trunk/src/site/apt/guides/development/guide-plugin-snapshot-repositories.apt
------------------------------------------------------------------------------
    svn:keywords = "Author Date Id Revision"

Modified: maven/site/trunk/src/site/apt/guides/index.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/index.apt?rev=430786&r1=430785&r2=430786&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/index.apt (original)
+++ maven/site/trunk/src/site/apt/guides/index.apt Fri Aug 11 06:19:03 2006
@@ -135,23 +135,24 @@
 
  * {{{development/guide-testing-development-plugins.html}Guide to Testing Development Versions of Plugins}}
 
+ * {{{development/guide-plugin-snapshot-repositories.html}Guide to Plugin Snapshot Repositories}}
 
 * Reference
 
  * {{{../ref/current/maven-model/maven.html}Project Descriptor}}
- 
+
  * {{{../ref/current/maven-settings/settings.html}Settings Descriptor}}
- 
+
  * {{{../plugins/index.html}Available Plug-ins}}
- 
+
  * {{{../developers/mojo-api-specification.html}Mojo API}}
- 
+
  * {{{../ant-tasks.html}Ant Tasks}}
- 
+
  * {{{../glossary.html}Glossary}}
- 
+
  * {{{../maven-conventions.html}Maven Conventions}}
 
  * {{{../articles.html}Articles}}
- 
+
  []