document <allbutfirst> and <allbutlast>
Project: http://git-wip-us.apache.org/repos/asf/ant/repo Commit: http://git-wip-us.apache.org/repos/asf/ant/commit/36ec8947 Tree: http://git-wip-us.apache.org/repos/asf/ant/tree/36ec8947 Diff: http://git-wip-us.apache.org/repos/asf/ant/diff/36ec8947 Branch: refs/heads/master Commit: 36ec8947fa5c47fd267c733c2dd499e4973d402a Parents: d7125a5 Author: Stefan Bodewig <[email protected]> Authored: Sun May 17 13:07:52 2015 +0200 Committer: Stefan Bodewig <[email protected]> Committed: Sun May 17 13:07:52 2015 +0200 ---------------------------------------------------------------------- WHATSNEW | 6 +- manual/Types/resources.html | 62 ++++++++++++++++++++ .../tools/ant/types/resources/AllButFirst.java | 2 +- 3 files changed, 68 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/ant/blob/36ec8947/WHATSNEW ---------------------------------------------------------------------- diff --git a/WHATSNEW b/WHATSNEW index 00b65fc..5ab9b9c 100644 --- a/WHATSNEW +++ b/WHATSNEW @@ -128,7 +128,11 @@ Other changes: * <scp> has new attributes fileMode and dirMode that control the permissions on the remote side when sending data via SSH. - Bugzilla Report 43271 + Bugzilla Report 43271. + + * New <allbutlast> and <allbutfirst> resource collections can be used + to select all but a given subset of a resource collection. + Bugzilla Report 57834. Changes from Ant 1.9.3 TO Ant 1.9.4 =================================== http://git-wip-us.apache.org/repos/asf/ant/blob/36ec8947/manual/Types/resources.html ---------------------------------------------------------------------- diff --git a/manual/Types/resources.html b/manual/Types/resources.html index 061168f..76d313b 100644 --- a/manual/Types/resources.html +++ b/manual/Types/resources.html @@ -359,6 +359,10 @@ Ant's "legacy" datatypes have been modified to behave as Resource Collections: nested collection</li> <li><a href="#last">last</a> - last <i>n</i> resources from a nested collection</li> + <li><a href="#allbutfirst">allbutfirst</a> - all except the + first <i>n</i> resources from a nested collection</li> + <li><a href="#allbutlast">last</a> - all except the last <i>n</i> + resources from a nested collection</li> <li><a href="#tokens">tokens</a> - <a href="#string">string</a> tokens gathered from a nested collection</li> <li><a href="#union">union</a> - set union of nested resource collections</li> @@ -964,6 +968,64 @@ larger collection. <strong>Since Ant 1.7.1</strong>.</p> <p>A single resource collection is required.</p> </blockquote> +<h4><a name="allbutfirst">allbutfirst</a></h4> +<p>Includes all elements except for the first <i>count</i> resources +from a nested resource collection. This can be used in conjunction +with the <a href="#sort">sort</a> collection, for example, to select +all but the first few oldest, largest, etc. resources from a larger +collection. <strong>Since Ant 1.9.5</strong>.</p> +<blockquote> + <table border="1" cellpadding="2" cellspacing="0"> + <tr> + <td valign="top"><b>Attribute</b></td> + <td valign="top"><b>Description</b></td> + <td align="center" valign="top"><b>Required</b></td> + </tr> + <tr> + <td valign="top">count</td> + <td valign="top">The number of resources to exclude</td> + <td valign="top" align="center">No, default 1</td> + </tr> + <tr> + <td valign="top">cache</td> + <td valign="top">Whether to cache results; disabling + may seriously impact performance</td> + <td valign="top" align="center">No, default <i>true</i></td> + </tr> + </table> + <h4>Parameters specified as nested elements</h4> + <p>A single resource collection is required.</p> +</blockquote> + +<h4><a name="allbutlast">allbutlast</a></h4> +<p>Includes all elements except for the last <i>count</i> resources +from a nested resource collection. This can be used in conjunction +with the <a href="#sort">sort</a> collection, for example, to select +all but the last few oldest, largest, etc. resources from a larger +collection. <strong>Since Ant 1.9.5</strong>.</p> +<blockquote> + <table border="1" cellpadding="2" cellspacing="0"> + <tr> + <td valign="top"><b>Attribute</b></td> + <td valign="top"><b>Description</b></td> + <td align="center" valign="top"><b>Required</b></td> + </tr> + <tr> + <td valign="top">count</td> + <td valign="top">The number of resources to exclude</td> + <td valign="top" align="center">No, default 1</td> + </tr> + <tr> + <td valign="top">cache</td> + <td valign="top">Whether to cache results; disabling + may seriously impact performance</td> + <td valign="top" align="center">No, default <i>true</i></td> + </tr> + </table> + <h4>Parameters specified as nested elements</h4> + <p>A single resource collection is required.</p> +</blockquote> + <h4><a name="tokens">tokens</a></h4> <p>Includes the <a href="#string">string</a> tokens gathered from a nested resource collection. Uses the same tokenizers supported by the http://git-wip-us.apache.org/repos/asf/ant/blob/36ec8947/src/main/org/apache/tools/ant/types/resources/AllButFirst.java ---------------------------------------------------------------------- diff --git a/src/main/org/apache/tools/ant/types/resources/AllButFirst.java b/src/main/org/apache/tools/ant/types/resources/AllButFirst.java index d9ea506..ffa665f 100644 --- a/src/main/org/apache/tools/ant/types/resources/AllButFirst.java +++ b/src/main/org/apache/tools/ant/types/resources/AllButFirst.java @@ -33,7 +33,7 @@ import org.apache.tools.ant.types.Resource; public class AllButFirst extends SizeLimitCollection { /** - * Take the first <code>count</code> elements. + * Take all elements except for the first <code>count</code> elements. * @return a Collection of Resources. */ protected Collection<Resource> getCollection() {
