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>


Reply via email to