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]