svn commit: r399789 - in /maven/maven-1/plugins/trunk/site/xdocs: changes.xml properties.xml

[lt...@apache.org]

Author: ltheussl
Date: Thu May  4 10:37:48 2006
New Revision: 399789

URL: http://svn.apache.org/viewcvs?rev=399789&view=rev
Log:
Add warnings about the default value of maven.site.failonerror.

Modified:
    maven/maven-1/plugins/trunk/site/xdocs/changes.xml
    maven/maven-1/plugins/trunk/site/xdocs/properties.xml

Modified: maven/maven-1/plugins/trunk/site/xdocs/changes.xml
URL: http://svn.apache.org/viewcvs/maven/maven-1/plugins/trunk/site/xdocs/changes.xml?rev=399789&r1=399788&r2=399789&view=diff
==============================================================================
--- maven/maven-1/plugins/trunk/site/xdocs/changes.xml (original)
+++ maven/maven-1/plugins/trunk/site/xdocs/changes.xml Thu May  4 10:37:48 2006
@@ -27,7 +27,7 @@
       <action dev="aheritier" type="add">New property <code>maven.site.gunzip.options</code> can be used to set options when using gunzip (default value is -f).</action>
       <action dev="ltheussl" type="fix" issue="MPSITE-40">Missing <code>maven.ssh.args</code> in <code>site:publish</code>.</action>
       <action dev="aheritier" type="fix" issue="MPSITE-39">Deploy site on unix create rights rwxr-xr-x. Group members can't override files. The default value for <code>maven.site.chmod.mode</code> is now <code>775</code>.</action>
-      <action dev="aheritier" type="add" issue="MPSITE-34">New property <code>maven.site.failonerror</code> can be used to bypass remote errors.</action>
+      <action dev="aheritier" type="add" issue="MPSITE-34">New property <code>maven.site.failonerror</code> can be used to bypass remote errors. Defaults to <code>true</code>. <strong>*NOTE*</strong> that this default will fail a deploy for any "minor" error, please read the properties documentation.</action>
       <action dev="ltheussl" type="add" issue="MPSITE-31">Make <code>chmod</code> options in <code>site:sshdeploy</code> configurable.</action>
       <action dev="ltheussl" type="fix" issue="MPSITE-24" due-to="Julian Dunn">SSH arguments not used in <code>sshdeploy</code> with 'clean'.</action>
       <action dev="aheritier" type="fix" issue="MPSITE-28" due-to="Davy Toch">Deploying the site documentation through SSH always results in 'Build Successful'.</action>

Modified: maven/maven-1/plugins/trunk/site/xdocs/properties.xml
URL: http://svn.apache.org/viewcvs/maven/maven-1/plugins/trunk/site/xdocs/properties.xml?rev=399789&r1=399788&r2=399789&view=diff
==============================================================================
--- maven/maven-1/plugins/trunk/site/xdocs/properties.xml (original)
+++ maven/maven-1/plugins/trunk/site/xdocs/properties.xml Thu May  4 10:37:48 2006
@@ -186,8 +186,14 @@
           <td>maven.site.failonerror</td>
           <td>Yes</td>
           <td>
-            Specifies if remote commands errors must stop the build. 
+            Specifies if errors in remote commands should stop the build.
             Defaults to <code>true</code>.
+            <strong>NOTE</strong> that with this default, a remote deploy will
+            fail for any "minor" error: for example if <code>tar</code> can't
+            overwrite a file or if the remote user doesn't have the needed rights
+            to change the permission for the root site directory
+            (like for the <code>htdocs</code> dir on sourceforge).
+            Sourceforge users are therefore advised to set this to <code>false</code>.
           </td>
         </tr>
         <tr>