From 9522e0c3b19e52377362460108fd14f886db6bab Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Tue, 18 Aug 2009 11:35:11 +0000
Subject: [PATCH] document chmod.fail property.  PR 22500

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@805369 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/install.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/manual/install.html b/docs/manual/install.html
index 1365bd673..1f2b8a1c1 100644
--- a/docs/manual/install.html
+++ b/docs/manual/install.html
@@ -679,6 +679,17 @@ This will only install the <code>bin</code> and <code>lib</code> directories.
 <code>install-lite</code> targets will overwrite
 the current Ant version in <code>ANT_HOME</code>.</p>
 
+<p>Ant's build script will try to set executable flags for its shell
+  scripts on Unix-like systems.  There are various reasons why the
+  chmod-task might fail (like when you are running the build script as
+  a different user than the one who installed Ant initially).  In this
+  case you can set the Ant property <code>chmod.fail</code> to false
+  when starting the build like in
+<blockquote>
+  <p><code>sh build.sh install -Dchmod.fail=false</code></p>
+</blockquote>
+and any error to change permission will not result in a build failure.</p>
+
 <hr>
 <h2><a name="librarydependencies">Library Dependencies</a></h2>
 <p>The following libraries are needed in Ant's classpath