diff --git a/src/site/markdown/examples/advancing-dependency-versions.md.vm b/src/site/markdown/examples/advancing-dependency-versions.md.vm index 6e4900898..188871f21 100644 --- a/src/site/markdown/examples/advancing-dependency-versions.md.vm +++ b/src/site/markdown/examples/advancing-dependency-versions.md.vm @@ -1,5 +1,5 @@ title: Advancing dependency versions -autor: Stephen Connolly +author: Stephen Connolly date: 2009-08-12 -Checking for new plugin updates +# Checking for new plugin updates - The <<>> goal will check all the plugins and reports used in your project and display a list - of those plugins with newer versions available, first staying with the same Maven version prerequisite, then - additional options if you update the Maven version prerequisite. +The `display-plugin-updates` goal will check all the plugins and reports used in your project and display a list +of those plugins with newer versions available, first staying with the same Maven version prerequisite, then +additional options if you update the Maven version prerequisite. - Here are some examples of what this looks like: +Here are some examples of what this looks like: ---- +```sh svn checkout http://svn.codehaus.org/mojo/trunk/mojo/build-helper-maven-plugin build-helper-maven-plugin cd build-helper-maven-plugin mvn versions:display-plugin-updates ---- +``` - Which produces the following output: +Which produces the following output: ---- +```log [INFO] ------------------------------------------------------------------------ [INFO] Building Build Helper Maven Plugin [INFO] task-segment: [versions:display-plugin-updates] @@ -84,15 +80,15 @@ mvn versions:display-plugin-updates [INFO] Finished at: Wed Nov 30 21:59:36 GMT 2011 [INFO] Final Memory: 21M/81M [INFO] ------------------------------------------------------------------------ ---- +``` - The plugin will also warn if you have not specified the versions of any plugins that you are using and tell you what - version you are currently using. Best practice in Maven is to always specify the plugin versions in order to - ensure that builds are reproducible. +The plugin will also warn if you have not specified the versions of any plugins that you are using and tell you what +version you are currently using. Best practice in Maven is to always specify the plugin versions in order to +ensure that builds are reproducible. - For example the following <<>>: +For example the following `pom.xml`: ---- +```xml 4.0.0 @@ -135,11 +131,11 @@ mvn versions:display-plugin-updates ---- +``` - produces the following output (when run using Maven 2.0.6): +produces the following output (when run using Maven 2.0.6): ---- +```log [INFO] ---------------------------------------------------------------------------- [INFO] Building Unnamed - org.codehaus.mojo.versions-maven-plugin.it:parent:pom:2.0 [INFO] task-segment: [versions:display-plugin-updates] @@ -202,18 +198,18 @@ mvn versions:display-plugin-updates [INFO] Finished at: Wed Nov 30 22:02:14 GMT 2011 [INFO] Final Memory: 26M/81M [INFO] ------------------------------------------------------------------------ ---- +``` - Note: that because the POM does not specify versions for some plugins, Maven - defaults to using the latest compatible version (Maven 3 complains about the - version not being specified), and hence the reported minimum required Maven - version tends to be the same as the version of Maven that is running the mojo +Note: that because the POM does not specify versions for some plugins, Maven +defaults to using the latest compatible version (Maven 3 complains about the +version not being specified), and hence the reported minimum required Maven +version tends to be the same as the version of Maven that is running the mojo - When run with Maven 2.0.9 (which defines versions of core plugins in the - super-pom, and removes some plugin from the lifecycle for the pom lifecycle), - we get the following output: +When run with Maven 2.0.9 (which defines versions of core plugins in the +super-pom, and removes some plugin from the lifecycle for the pom lifecycle), +we get the following output: ---- +```log [INFO] ------------------------------------------------------------------------ [INFO] Building Unnamed - org.codehaus.mojo.versions-maven-plugin.it:parent:pom:2.0 [INFO] task-segment: [versions:display-plugin-updates] @@ -264,11 +260,11 @@ mvn versions:display-plugin-updates [INFO] Finished at: Wed Nov 30 22:09:59 GMT 2011 [INFO] Final Memory: 20M/81M [INFO] ------------------------------------------------------------------------ ---- +``` - And the following POM: +And the following POM: ---- +```xml 4.0.0 @@ -312,11 +308,11 @@ mvn versions:display-plugin-updates ---- +``` produces the following output: ---- +```log [INFO] ------------------------------------------------------------------------ [INFO] Building Unnamed - org.codehaus.mojo.versions-maven-plugin.it:child:pom:2.0 [INFO] task-segment: [versions:display-plugin-updates] @@ -351,4 +347,4 @@ mvn versions:display-plugin-updates [INFO] Finished at: Fri Nov 25 18:28:34 GMT 2011 [INFO] Final Memory: 17M/81M [INFO] ------------------------------------------------------------------------ ---- \ No newline at end of file +``` diff --git a/src/site/markdown/faq.md b/src/site/markdown/faq.md index b7872d5d7..7367e3813 100644 --- a/src/site/markdown/faq.md +++ b/src/site/markdown/faq.md @@ -1,5 +1,5 @@ title: FAQ -autor: Stephen Connolly +author: Stephen Connolly