mbenson 2005/01/27 09:47:31
Modified: docs/manual using.html
Log:
Rewording the References section.
PR: 33274
Revision Changes Path
1.37 +19 -11 ant/docs/manual/using.html
Index: using.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/using.html,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- using.html 16 Dec 2004 16:23:22 -0000 1.36
+++ using.html 27 Jan 2005 17:47:31 -0000 1.37
@@ -503,11 +503,13 @@
<code>/dir:/dir2:/dir3</code> on Unix-like systems.</p>
<h3><a name="references">References</a></h3>
-<p>The <code>id</code> attribute of the buildfile's elements can be
-used to refer to them. This can be useful if you are going to replicate
-the same snippet of XML over and over again - using a
-<code><classpath></code> structure more than once, for
-example.</p>
+
+<p>Any project element can be assigned an identifier using its
+<code>id</code> attribute. In most cases the element can subsequently
+be referenced by specifying the <code>refid</code> attribute on an
+element of the same type. This can be useful if you are going to
+replicate the same snippet of XML over and over again--using a
+<code><classpath></code> structure more than once, for example.</p>
<p>The following example:</p>
<blockquote><pre>
<project ... >
@@ -554,14 +556,20 @@
</target>
</project>
</pre></blockquote>
-<p>All tasks that use nested elements for <a
-href="CoreTypes/patternset.html">PatternSet</a>s, <a
href="CoreTypes/fileset.html">FileSet</a>s,
-<a href="CoreTypes/zipfileset.html">ZipFileSet</a>s or
-<a href="#path">path-like structures</a> accept references to these
-structures as well.</p>
+<p>All tasks that use nested elements for
+<a href="CoreTypes/patternset.html">PatternSet</a>s,
+<a href="CoreTypes/fileset.html">FileSet</a>s,
+<a href="CoreTypes/zipfileset.html">ZipFileSet</a>s or
+<a href="#path">path-like structures</a> accept references to these
structures
+as shown in the examples. Using <code>refid</code> on a task will ordinarily
+have the same effect (referencing a task already declared), but the user
+should be aware that the interpretation of this attribute is dependent on the
+implementation of the element upon which it is specified. Some tasks (the
+<a href="CoreTasks/property.html">property</a> task is a handy example)
+deliberately assign a different meaning to <code>refid</code>.</p>
<hr>
-<p align="center">Copyright © 2000-2004 The Apache Software Foundation.
All rights
+<p align="center">Copyright © 2000-2005 The Apache Software Foundation.
All rights
Reserved.</p>
</body>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
