Author: mbenson
Date: Wed Sep 14 14:20:52 2005
New Revision: 280942
URL: http://svn.apache.org/viewcvs?rev=280942&view=rev
Log:
rework different selector doc
Modified:
ant/core/trunk/docs/manual/CoreTypes/selectors.html
Modified: ant/core/trunk/docs/manual/CoreTypes/selectors.html
URL:
http://svn.apache.org/viewcvs/ant/core/trunk/docs/manual/CoreTypes/selectors.html?rev=280942&r1=280941&r2=280942&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/CoreTypes/selectors.html (original)
+++ ant/core/trunk/docs/manual/CoreTypes/selectors.html Wed Sep 14 14:20:52 2005
@@ -305,32 +305,30 @@
<a name="differentselect">
<h4>Different Selector</h4>
- <p>The <code><different></code> tag selects files
- who are deemed to be 'different' from another, equivalent file in
- another location. The rules for determining difference between two
- files are as follows:
+ <p>The <code><different></code> selector will select a file
+ if it is deemed to be 'different' from an equivalent file in
+ another location. The rules for determining difference between
+ the two files are as follows:
<ol>
<li> If there is no 'other' file, it's different.
<li> Files with different lengths are different.
<li> If <tt>ignoreFileTimes</tt> is turned off, then differing file
timestamps will cause files to be regarded as different.
- <li> Unless<tt>ignoreContents</tt> is set to true, a byte-for-byte check
is run
- against the two files
+ <li> Unless <tt>ignoreContents</tt> is set to true,
+ a byte-for-byte check is run against the two files.
</ol>
This is a useful selector to work with programs and tasks that don't handle
- dependency checking properly; Even if a predecessor task always creates its
- output files, followup tasks can be driven off copies made with a
different selector,
- so their dependencies are driven on the absolute state of the files, not
just
- a timestamp. For example: anything fetched from a web site, or the output
of
- some program. To reduce the amount of checking, when using this task inside
- a <code><copy></code> task, set the <tt>preservelastmodified</tt> to
propagate the timestamp
- from source file to destintaion file.
+ dependency checking properly; even if a predecessor task always creates its
+ output files, followup tasks can be driven off copies made with a different
+ selector, so their dependencies are driven on the absolute state of the
+ files, not just a timestamp. For example: anything fetched from a web site,
+ or the output of some program. To reduce the amount of checking, when using
+ this task inside a <code><copy></code> task, set
+ <tt>preservelastmodified</tt> to <i>true</i> to propagate the timestamp
+ from the source file to the destination file.<p>
-
- <p>
-
- The <code><different></code> tag supports the use of a
+ The <code><different></code> selector supports the use of a
contained <a href="mapper.html"><code><mapper></code></a> element
to define the location of the file to be compared against. If no
<code><mapper></code> element is specified, the
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]