diff --git a/docs/manual/CoreTypes/selectors.html b/docs/manual/CoreTypes/selectors.html index dbd9f9bdc..8669e1eef 100755 --- a/docs/manual/CoreTypes/selectors.html +++ b/docs/manual/CoreTypes/selectors.html @@ -305,32 +305,30 @@

Different Selector

-

The <different> 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: +

The <different> 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:

  1. If there is no 'other' file, it's different.
  2. Files with different lengths are different.
  3. If ignoreFileTimes is turned off, then differing file timestamps will cause files to be regarded as different. -
  4. UnlessignoreContents is set to true, a byte-for-byte check is run - against the two files +
  5. Unless ignoreContents is set to true, + a byte-for-byte check is run against the two files.
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 <copy> task, set the preservelastmodified to propagate the timestamp - from source file to destintaion file. - - -

- - The <different> tag supports the use of a + 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 <copy> task, set + preservelastmodified to true to propagate the timestamp + from the source file to the destination file.

+ + The <different> selector supports the use of a contained <mapper> element to define the location of the file to be compared against. If no <mapper> element is specified, the