You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ant.apache.org by bo...@apache.org on 2015/05/17 13:20:53 UTC
[2/2] ant git commit: document and
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 <bo...@apache.org>
Authored: Sun May 17 13:07:52 2015 +0200
Committer: Stefan Bodewig <bo...@apache.org>
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() {