From a77432f1aa2b458b61dd1435f177c4e6a4bad82f Mon Sep 17 00:00:00 2001
From: Peter Reilly <peterreilly@apache.org>
Date: Mon, 24 Nov 2003 16:35:31 +0000
Subject: [PATCH] Clarify when properties are resolved when using presetdef

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

diff --git a/docs/manual/CoreTasks/presetdef.html b/docs/manual/CoreTasks/presetdef.html
index 166d643af..71be361eb 100644
--- a/docs/manual/CoreTasks/presetdef.html
+++ b/docs/manual/CoreTasks/presetdef.html
@@ -22,6 +22,11 @@
     <p>
       <em>since Ant 1.6</em>
     </p>
+    <p>
+      The resolution of properties in any of the attributes or
+      nested text takes place with the definition is used and <em>not</em>
+      when the preset definition is defined.
+    </p>
     <h3>Parameters</h3>
     <table border="1" cellpadding="2" cellspacing="0">
       <tr>
@@ -105,6 +110,41 @@
 &lt;/project&gt;
 </pre>
     </blockquote>
+    <p>
+      The following is an example of evaluation of properties when the
+      definition is used:
+    </p>
+     <blockquote>
+<pre class="code">
+&lt;target name="defineandcall"&gt;
+   &lt;presetdef name="showmessage"&gt;
+      &lt;echo&gt;message is '${message}'&lt;/echo&gt;
+   &lt;/presetdef&gt;
+   &lt;showmessage/&gt;
+   &lt;property name="message" value="Message 1"/&gt;
+   &lt;showmessage/&gt;
+   &lt;antcall target="called"&gt;
+      &lt;param name="message" value="Message 2"/&gt;
+   &lt;/antcall&gt;
+&lt;/target&gt;
+&lt;target name="called"&gt;
+   &lt;showmessage/&gt;
+&lt;/target&gt;
+</pre>
+     </blockquote>
+     <p>
+        The command ant defineandcall results in the output:
+     </p>
+     <blockquote>
+<pre class="code">
+defineandcall:
+[showmessage] message is '${message}'
+[showmessage] message is 'Message 1'
+
+called:
+[showmessage] message is 'Message 2'
+</pre>
+     </blockquote>
     <hr></hr>
     <p align="center">Copyright &copy; 2003 Apache Software
       Foundation. All rights Reserved.</p>