svn commit: r1150691 - in /maven/plugins/trunk/maven-site-plugin/src/site/apt: examples/adding-deploy-protocol.apt.vm maven-3.apt.vm

[lt...@apache.org]

Author: ltheussl
Date: Mon Jul 25 13:18:53 2011
New Revision: 1150691

URL: http://svn.apache.org/viewvc?rev=1150691&view=rev
Log:
doc polishing

Modified:
    maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/adding-deploy-protocol.apt.vm
    maven/plugins/trunk/maven-site-plugin/src/site/apt/maven-3.apt.vm

Modified: maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/adding-deploy-protocol.apt.vm
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/adding-deploy-protocol.apt.vm?rev=1150691&r1=1150690&r2=1150691&view=diff
==============================================================================
--- maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/adding-deploy-protocol.apt.vm (original)
+++ maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/adding-deploy-protocol.apt.vm Mon Jul 25 13:18:53 2011
@@ -27,14 +27,16 @@
  ~~ http://maven.apache.org/doxia/references/apt-format.html
 
 
-Adding a Protocol to Deploy the Site 
+Adding a Protocol to Deploy the Site
 
-  Maven 3 - then Maven Site Plugin - comes with minimal built-in protocol support: <<<file>>>, <<<http>>>, <<<https>>>.
-  Maven 2 adds <<<scp>>> to this list.
+  Out of the box, Maven 3 only supports <<<file:>>>, <<<http:>>> and <<<https:>>> as transport protocols.
+  Maven 2 adds <<<scp:>>> to this list.
 
-  To deploy a site with a non-built-in protocol, you'll need to add a new {{{http://maven.apache.org/wagon}wagon provider}}.
+  To deploy a site with a non-built-in protocol, you need to add the corresponding
+  {{{http://maven.apache.org/wagon/}wagon provider}}.
 
-  You can add it either as a global extension, or just let it at site plugin level:
+  You can add it either as a {{{http://maven.apache.org/guides/mini/guide-using-extensions.html}global extension}},
+  or declare it at as a dependency of the site plugin:
 
 +-----+
 <project>

Modified: maven/plugins/trunk/maven-site-plugin/src/site/apt/maven-3.apt.vm
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-site-plugin/src/site/apt/maven-3.apt.vm?rev=1150691&r1=1150690&r2=1150691&view=diff
==============================================================================
--- maven/plugins/trunk/maven-site-plugin/src/site/apt/maven-3.apt.vm (original)
+++ maven/plugins/trunk/maven-site-plugin/src/site/apt/maven-3.apt.vm Mon Jul 25 13:18:53 2011
@@ -35,11 +35,13 @@ Using it with Maven 3
   ({{{http://jira.codehaus.org/browse/MNG-4162}MNG-4162}}).
 
   As a result, the 2.x versions of the Maven Site Plugin will not work with Maven 3.
-  Using such versions of Maven Site Plugin with Maven 3 won't generate any reports from reporting plugin,
+  Using such versions of Maven Site Plugin with Maven 3 won't generate any reports from reporting plugins,
   only hand-written Doxia documents (apt, xdoc, ...) will be rendered.
 
   You need to use version 3.x of the Site Plugin, in order for it to work with Maven 3.
 
+%{toc|section=1|fromDepth=2|toDepth=3}
+
 * Plugins Compatibility Matrix for Maven 3
 
 ** Plugins Maintained by the Apache Maven Community