@@ -1,5 +1,5 @@
<html> <html>
<head> <head>
<meta http-equiv="Content-Language" content="en-us"></meta> <meta http-equiv="Content-Language" content="en-us"></meta>
<title>MacroDef Task</title> <title>MacroDef Task</title>
@@ -9,18 +9,23 @@
--> -->
</style> </style>
</head> </head>
<body> <body>
<h2><a name="macrodef">MacroDef</a></h2> <h2><a name="macrodef">MacroDef</a></h2>
<h3>Description</h3> <h3>Description</h3>
<p> <p>
This defines a new task using a <sequential>
This defines a new task using a <sequential>
nested task as a template. Nested elements <attribute> and nested task as a template. Nested elements <attribute> and
<element> are used to specify attributes and elements of <element> are used to specify attributes and elements of
the new task. These get substituted into the <sequential> the new task. These get substituted into the <sequential>
task when the new task is run. task when the new task is run.
</p> </p>
<h3>Note</h3>
<p>
You can also use <i>prior defined</i> attributes for default-values in
other attributes. See the examples.
</p>
<p> <p>
<em>since Ant 1.6</em> <em>since Ant 1.6</em>
</p> </p>
@@ -183,7 +188,7 @@
<td valign="top" align="center">No</td> <td valign="top" align="center">No</td>
</tr> </tr>
</table> </table>
<h3>Examples</h3> <h3>Examples</h3>
<p> <p>
The following example defined a task called testing and The following example defined a task called testing and
@@ -264,6 +269,26 @@
<echotest> <echotest>
Hello world Hello world
</echotest> </echotest>
</pre>
</blockquote>
<p>
The following uses a prior defined attribut for setting the
default value of another. The output would be
<tt>one=test two=test</tt>. If you change the order of lines
*1 and *2 the output would be <tt>one=test two=@{one}</tt>,
because while processing the <i>two</i>-line the value for
<i>one</i> is not set.
</p>
<blockquote>
<pre class="code">
<macrodef name="test"/>
<attribute name="one"/> <b>*1</b>
<attribute name="two" default="@{one}"/> <b>*2</b>
<sequential>
<echo>one=@{one} two=@{two}</echo>
</sequential>
</macrodef/>
<test one="test"/>
</pre> </pre>
</blockquote> </blockquote>
<hr> <hr>
@@ -272,4 +297,3 @@ Foundation. All rights Reserved.</p>
</body> </body>
</html> </html>
Jan Materne