@@ -14,18 +14,18 @@
<h3>How to use a Selector</h3>
<h3>How to use a Selector</h3>
<p>A selector is an element of FileSet, and appears within it. It can
<p>A selector is an element of FileSet, and appears within it. It can
also be defined outside of any target by using the <selector> tag
also be defined outside of any target by using the <selector> tag
and then using it as a reference.
and then using it as a reference.
</p>
</p>
<p>Different selectors have different attributes. Some selectors can
<p>Different selectors have different attributes. Some selectors can
contain other selectors, and these are called
<a href="#selectcontainers"><code>Selector Containers</code></a>.
contain other selectors, and these are called
<a href="#selectcontainers"><code>Selector Containers</code></a>.
There is also a category of selectors that allow
There is also a category of selectors that allow
user-defined extensions, called
user-defined extensions, called
<a href="#customselect"><code>Custom Selectors</code></a>.
<a href="#customselect"><code>Custom Selectors</code></a>.
The ones built in to Ant are called
The ones built in to Ant are called
<a href="#coreselect"><code>Core Selectors</code></a>.
<a href="#coreselect"><code>Core Selectors</code></a>.
</p>
</p>
@@ -88,6 +88,14 @@
</td>
</td>
<td valign="top" align="center">No</td>
<td valign="top" align="center">No</td>
</tr>
</tr>
<tr>
<td valign="top">ignorewhitespace</td>
<td valign="top">Whether to eliminate whitespace before checking
for the string in the <code>text</code> attribute. Default is
false.
</td>
<td valign="top" align="center">No</td>
</tr>
</table>
</table>
<p>Here is an example of how to use the Contains Selector:</p>
<p>Here is an example of how to use the Contains Selector:</p>
@@ -164,11 +172,11 @@
<p>The <code><depend></code> tag selects files
<p>The <code><depend></code> tag selects files
whose last modified date is later than another, equivalent file in
whose last modified date is later than another, equivalent file in
another location.</p>
another location.</p>
<p>The <code><depend></code> tag supports the use of a
<p>The <code><depend></code> tag 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
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
<code>identity</code> type mapper is used.</p>
<code>identity</code> type mapper is used.</p>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
@@ -204,7 +212,7 @@
</fileset>
</fileset>
</pre></blockquote>
</pre></blockquote>
<p>Selects all the Java source files which were modified in the
<p>Selects all the Java source files which were modified in the
1.5 release.
1.5 release.
</p>
</p>
@@ -385,11 +393,11 @@
<p>The <code><present></code> tag selects files
<p>The <code><present></code> tag selects files
that have an equivalent file in another directory tree.</p>
that have an equivalent file in another directory tree.</p>
<p>The <code><present></code> tag supports the use of a
<p>The <code><present></code> tag supports the use of a
contained <a href="mapper.html"><code><mapper></code></a> element
to define the location of the file to be tested against. If no
<code><mapper></code> element is specified, the
contained <a href="mapper.html"><code><mapper></code></a> element
to define the location of the file to be tested against. If no
<code><mapper></code> element is specified, the
<code>identity</code> type mapper is used.</p>
<code>identity</code> type mapper is used.</p>
<table border="1" cellpadding="2" cellspacing="0">
<table border="1" cellpadding="2" cellspacing="0">
@@ -408,18 +416,18 @@
</tr>
</tr>
<tr>
<tr>
<td valign="top">present</td>
<td valign="top">present</td>
<td valign="top">Whether we are requiring that a file is present in
<td valign="top">Whether we are requiring that a file is present in
the src directory tree only, or in both the src and the target
the src directory tree only, or in both the src and the target
directory tree. Valid values are:
directory tree. Valid values are:
<ul>
<ul>
<li>srconly - select files only if they are in the src
<li>srconly - select files only if they are in the src
directory tree but not in the target directory tree
directory tree but not in the target directory tree
<li>both - select files only if they are present both in the
<li>both - select files only if they are present both in the
src and target directory trees
src and target directory trees
</ul>
</ul>
Default is both. Setting this attribute to "srconly"
Default is both. Setting this attribute to "srconly"
is equivalent to wrapping the selector in the <not>
selector container.
is equivalent to wrapping the selector in the <not>
selector container.
</td>
</td>
<td valign="top" align="center">No</td>
<td valign="top" align="center">No</td>
</tr>
</tr>
@@ -433,7 +441,7 @@
</fileset>
</fileset>
</pre></blockquote>
</pre></blockquote>
<p>Selects all the Java source files which are new in the
<p>Selects all the Java source files which are new in the
1.5 release.
1.5 release.
</p>
</p>
@@ -560,7 +568,7 @@
soon as it finds a selector that does not select the file,
soon as it finds a selector that does not select the file,
so it is not guaranteed to check every selector.
so it is not guaranteed to check every selector.
</p>
</p>
<p>Here is an example of how to use the And Selector:</p>
<p>Here is an example of how to use the And Selector:</p>
<blockquote><pre>
<blockquote><pre>
@@ -614,8 +622,8 @@
</fileset>
</fileset>
</pre></blockquote>
</pre></blockquote>
<p>Selects all the HTML files which contain at least two of the three
phrases "project", "taskdef", and "IntrospectionHelper" (this last phrase must
<p>Selects all the HTML files which contain at least two of the three
phrases "project", "taskdef", and "IntrospectionHelper" (this last phrase must
match case exactly).
match case exactly).
</p>
</p>
@@ -628,7 +636,7 @@
soon as it finds a selector that selects the file,
soon as it finds a selector that selects the file,
so it is not guaranteed to check every selector.
so it is not guaranteed to check every selector.
</p>
</p>
<p>Here is an example of how to use the None Selector:</p>
<p>Here is an example of how to use the None Selector:</p>
<blockquote><pre>
<blockquote><pre>
@@ -642,7 +650,7 @@
</fileset>
</fileset>
</pre></blockquote>
</pre></blockquote>
<p>Selects only Java files which do not have equivalent java or
<p>Selects only Java files which do not have equivalent java or
class files in the dest directory.
class files in the dest directory.
</p>
</p>
@@ -653,7 +661,7 @@
<p>The <code><not></code> tag reverses the meaning of the
<p>The <code><not></code> tag reverses the meaning of the
single selector it contains.
single selector it contains.
</p>
</p>
<p>Here is an example of how to use the Not Selector:</p>
<p>Here is an example of how to use the Not Selector:</p>
<blockquote><pre>
<blockquote><pre>
@@ -677,7 +685,7 @@
soon as it finds a selector that selects the file,
soon as it finds a selector that selects the file,
so it is not guaranteed to check every selector.
so it is not guaranteed to check every selector.
</p>
</p>
<p>Here is an example of how to use the Or Selector:</p>
<p>Here is an example of how to use the Or Selector:</p>
<blockquote><pre>
<blockquote><pre>
@@ -691,7 +699,7 @@
</fileset>
</fileset>
</pre></blockquote>
</pre></blockquote>
<p>Selects all the files in the top directory along with all the
<p>Selects all the files in the top directory along with all the
image files below it.
image files below it.
</p>
</p>