svn commit: r1386942 - /maven/wagon/trunk/wagon-providers/wagon-scm/src/site/apt/usage.apt.vm

[hb...@apache.org]

Author: hboutemy
Date: Tue Sep 18 00:56:14 2012
New Revision: 1386942

URL: http://svn.apache.org/viewvc?rev=1386942&view=rev
Log:
document more shortcomings to site plugin + Wagon SCM

Modified:
    maven/wagon/trunk/wagon-providers/wagon-scm/src/site/apt/usage.apt.vm

Modified: maven/wagon/trunk/wagon-providers/wagon-scm/src/site/apt/usage.apt.vm
URL: http://svn.apache.org/viewvc/maven/wagon/trunk/wagon-providers/wagon-scm/src/site/apt/usage.apt.vm?rev=1386942&r1=1386941&r2=1386942&view=diff
==============================================================================
--- maven/wagon/trunk/wagon-providers/wagon-scm/src/site/apt/usage.apt.vm (original)
+++ maven/wagon/trunk/wagon-providers/wagon-scm/src/site/apt/usage.apt.vm Tue Sep 18 00:56:14 2012
@@ -48,9 +48,17 @@ Maven Wagon SCM Usage
 
 Deploying your Maven site to SCM
 
- Generated site may have inconsistent newlines (see {{{http://jira.codehaus.org/browse/MSITE-121}MSITE-121}}),
- preventing SCM check-in: prefer {{{http://maven.apache.org/plugins/maven-scm-publish-plugin/}maven-scm-publish-plugin}} to
- publish your site to SCM.
+ There are some shortcomings to simply using Wagon SCM provider with site plugin:
+
+ * generated site may have inconsistent newlines (see {{{http://jira.codehaus.org/browse/MSITE-121}MSITE-121}}),
+ preventing SCM check-in,
+
+ * deploying site to SCM will require obsolete pages deletion, which is not done,
+
+ * site plugin way make one commit per file.
+
+ Prefer {{{http://maven.apache.org/plugins/maven-scm-publish-plugin/}maven-scm-publish-plugin}} to
+ publish your site to SCM
 
  <<Note for Maven 3 users:>> The site plugin behaves differently, require these
  be added as dependencies instead of extensions. See