Author: brett
Date: Wed Nov 23 16:26:26 2005
New Revision: 348599
URL: http://svn.apache.org/viewcvs?rev=348599&view=rev
Log:
create a guide to testing development plugins
Added:
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
(with props)
Modified:
maven/site/trunk/src/site/apt/guides/index.apt
Added:
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
URL:
http://svn.apache.org/viewcvs/maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt?rev=348599&view=auto
==============================================================================
---
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
(added)
+++
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
Wed Nov 23 16:26:26 2005
@@ -0,0 +1,74 @@
+ ------
+ Guide to Testing Development Versions of Plugins
+ ------
+ Brett Porter
+ ------
+ 24 November 2005
+ ------
+
+Guide to Testing Development Versions of Plugins
+
+* Why would I want to do this?
+
+ If a bug you are encountering has been reported as fixed but not yet
released, you can confirm that it has been fixed
+ for you. Or perhaps you just like to live on the bleeding edge.
+
+ <Note:> This is <<not>> recommended as an everyday or in production practice!
+
+* How do I do this?
+
+ Development versions of Maven plugins are periodically published to the
repository: {{http://snapshots.maven.codehaus.org/maven2}}
+
+ <Note:> Currently, this is not done automatically by our continuous
integration setup. This is coming soon.
+
+ The first step is to include this in your project:
+
+-------
+<pluginRepositories>
+ <pluginRepository>
+ <id>snapshots</id>
+ <url>http://snapshots.maven.codehaus.org/maven2</url>
+ </pluginRepository>
+</pluginRepositories>
+-------
+
+ <Note:> If you are using the goals from the command line on a number of
projects, you should include this in your
+ <<<settings.xml>>> file instead.
+
+ After this is included, there are three ways to use the updated versions:
+
+ * Set the appropriate version in the plugin, eg <<<2.0.1-SNAPSHOT>>>
+
+ * If you have not specified a version, use the <<<-U>>> switch to update
plugins for the given Maven run
+
+ * You can have Maven automatically check for updates on a given interval,
for example:
+
+-------
+<pluginRepositories>
+ <pluginRepository>
+ <id>snapshots</id>
+ <url>http://snapshots.maven.codehaus.org/maven2</url>
+ <!-- The releases element here is due to an issue in Maven 2.0 that will
be fixed in future releases.
+ This should be able to be disabled altogether. -->
+ <releases>
+ <updatePolicy>daily</updatePolicy>
+ </releases>
+ <snapshots>
+ <updatePolicy>daily</updatePolicy>
+ </snapshots>
+ </pluginRepository>
+</pluginRepositories>
+-------
+
+ <Note:> These last two techniques mean that <every> plugin will be updated
to the latest snapshot version. Finer grained
+ control will be available in future versions.
+
+* How do I stop doing this?
+
+ The development version will stop being used if the
<<<\<pluginRepository\>>>> element is removed from your POM or
+ settings (regardless of what is in your local repository).
+
+* How do I make changes to the source and test development versions of the
plugins?
+
+ For information on this, see the {{{guide-m2-development.html} Guide to
Maven 2.0 Development}}.
+
\ No newline at end of file
Propchange:
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
------------------------------------------------------------------------------
svn:eol-style = native
Propchange:
maven/site/trunk/src/site/apt/guides/development/guide-testing-development-plugins.apt
------------------------------------------------------------------------------
svn:keywords = Author Date Id Revision
Modified: maven/site/trunk/src/site/apt/guides/index.apt
URL:
http://svn.apache.org/viewcvs/maven/site/trunk/src/site/apt/guides/index.apt?rev=348599&r1=348598&r2=348599&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/index.apt (original)
+++ maven/site/trunk/src/site/apt/guides/index.apt Wed Nov 23 16:26:26 2005
@@ -30,14 +30,12 @@
* {{{mini/guide-creating-archetypes.html}Guide to Creating Archetypes}}
- * {{{mini/guide-creating-plugin-with-lifecycle-modifications.html}Guide to
creating plug-ins with lifecycle modifications}}
-
* {{{mini/guide-deploy-ftp.html}Guide to deploying with FTP}}
- * {{{mini/guide-deployment-security-settings.html}Guide to Deployment and
Security Settings}}
-
* {{{mini/guide-deploy-ssh-external.html}Guide to deploying with an external
SSH command}}
+ * {{{mini/guide-deployment-security-settings.html}Guide to Deployment and
Security Settings}}
+
* {{{mini/guide-ear.html}Guide to EARs}}
* {{{mini/guide-embedding-m2.html}Guide to Embedding Maven 2.x}}
@@ -126,6 +124,8 @@
* {{{development/guide-helping.html}Guide to helping with Maven}}
* {{{development/guide-m2-development.html}Guide to Developing Maven}}
+
+ * {{{development/guide-testing-development-plugins.html}Guide to Testing
Development Versions of Plugins}}
* Reference
