ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mben...@apache.org
Subject cvs commit: ant/docs/manual using.html
Date Thu, 27 Jan 2005 17:47:31 GMT
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>&lt;classpath&gt;</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>&lt;classpath&gt;</code> structure more than once, for example.</p>
   <p>The following example:</p>
   <blockquote><pre>
   &lt;project ... &gt;
  @@ -554,14 +556,20 @@
     &lt;/target&gt;
   &lt;/project&gt;
   </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 &copy; 2000-2004 The Apache Software Foundation.
All rights
  +<p align="center">Copyright &copy; 2000-2005 The Apache Software Foundation.
All rights
   Reserved.</p>
   
   </body>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message