summaryrefslogtreecommitdiff
path: root/manual
diff options
context:
space:
mode:
authorMatt Benson <mbenson@apache.org>2022-02-25 18:48:19 -0600
committerMatt Benson <mbenson@apache.org>2022-02-25 18:48:19 -0600
commite7c48c8f8677cd3dff58f3b836b41543f8e37032 (patch)
treef1d25db68d4c4a0fca4d8c2ba9a9f3f4cb56a38a /manual
parentc4552aaaf2932144e2d689a838a9a0db02c64741 (diff)
downloadant-e7c48c8f8677cd3dff58f3b836b41543f8e37032.tar.gz
local += nested name elements
Diffstat (limited to 'manual')
-rw-r--r--manual/Tasks/local.html16
1 files changed, 16 insertions, 0 deletions
diff --git a/manual/Tasks/local.html b/manual/Tasks/local.html
index 830cc1858..2e64ec631 100644
--- a/manual/Tasks/local.html
+++ b/manual/Tasks/local.html
@@ -53,6 +53,12 @@ examples section.</p>
</tr>
</table>
+<h3>Parameters specified as nested elements</h3>
+<h4>Name</h4>
+<p>As an alternative to (or in conjunction with) the <code>name</code> attribute, the nested text of
+each of one or more nested <code>&lt;name&gt;</code> elements specifies a property name to declare in
+the local scope.
+
<h3>Examples</h3>
<h4>Temporarily shadow a global property's value</h4>
@@ -171,5 +177,15 @@ come up with unique names in some cases.</p>
<p>Each invocation gets its own property named <code>parent</code> and there will be no global
property of that name at all.</p>
+<h4>Use of nested name elements</h4>
+This style declares and executes a single task, as compensation for requiring more lines of XML than
+would individual invocations using <code>@name</code>:
+<pre>
+&lt;local&gt;
+ &lt;name&gt;foo&lt;/name&gt;
+ &lt;name&gt;bar&lt;/name&gt;
+ &lt;name&gt;baz&lt;/name&gt;
+&lt;/local&gt;
+</pre>
</body>
</html>