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 2020/09/30 16:35:00 UTC

svn commit: r1882159 [2/25] - in /ant/site/ant/production: ./ manual/ manual/Tasks/ manual/Types/ manual/api/ manual/api/org/apache/tools/ant/ manual/api/org/apache/tools/ant/attribute/ manual/api/org/apache/tools/ant/dispatch/ manual/api/org/apache/to...

Modified: ant/site/ant/production/doap_Ant.rdf
URL: http://svn.apache.org/viewvc/ant/site/ant/production/doap_Ant.rdf?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/doap_Ant.rdf (original)
+++ ant/site/ant/production/doap_Ant.rdf Wed Sep 30 16:34:48 2020
@@ -35,6 +35,13 @@
     <category rdf:resource="http://projects.apache.org/category/build-management" />
     <release>
       <Version>
+        <name>Apache Ant 1.10.9</name>
+        <created>2020-09-30</created>
+        <revision>1.10.9</revision>
+      </Version>
+    </release>    
+    <release>
+      <Version>
         <name>Apache Ant 1.10.8</name>
         <created>2020-05-13</created>
         <revision>1.10.8</revision>

Modified: ant/site/ant/production/manual/Tasks/jar.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/jar.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/jar.html (original)
+++ ant/site/ant/production/manual/Tasks/jar.html Wed Sep 30 16:34:48 2020
@@ -349,6 +349,14 @@ names used for the archives depend on yo
 inside the <samp>META-INF</samp> directory unless the <var>indexmetainf</var> attribute has been set
 to <q>true</q>.</p>
 
+<h4 id="indexjarsmapper">indexjarsmapper</h4>
+
+<p><em>Since Ant 1.10.9</em></p>
+
+<p>The nested <code>indexjarsmapper</code> element can be used to perform custom filename
+transformations for the archives specified by <code>indexjars</code> if the
+<a href="#indexjars">default filename transformation</a> doesn't suffice.
+
 <h4 id="service">service</h4>
 
 <p><em>Since Ant 1.7.0</em></p>

Modified: ant/site/ant/production/manual/Tasks/rmic.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/rmic.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/rmic.html (original)
+++ ant/site/ant/production/manual/Tasks/rmic.html Wed Sep 30 16:34:48 2020
@@ -30,7 +30,7 @@
 
 <p><b>Note</b> <kbd>rmic</kbd> has been deprecated as of Java 13 and
   removed as of Java 15. Trying to use it with Java15 will fail unless
-  you specifiy the execxutable or rmic-adapter explicitly.</p>
+  you specify the executable or rmic-adapter explicitly.</p>
 
 <p><code>Rmic</code> can be run on a single class (as specified with the classname attribute) or a
 number of classes at once (all classes below base that are neither <code>_Stub</code>

Modified: ant/site/ant/production/manual/Tasks/script.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/script.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/script.html (original)
+++ ant/site/ant/production/manual/Tasks/script.html Wed Sep 30 16:34:48 2020
@@ -274,11 +274,32 @@ with <code>importClass</code>/<code>impo
 full classified name with <strong>Packages</strong>. For example
 Ant's <code class="code">FileUtils</code> class can be imported
 with <code class="code">importClass(<strong>Packages</strong>.org.apache.tools.ant.util.FileUtils)</code></p>
-<p>In Java 8+, you may use the built-in Nashorn JavaScript engine rather than Rhino (which is
+<p>In Java 8 up until Java 14, you may use the built-in Nashorn JavaScript engine rather than Rhino (which is
 available in Java 7 runtime). Then, use <code>Java.type</code> as import statement for any Java
 class
 or <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/prog_guide/javascript.html#A1147207">the
 compatibility script</a>: <code>load("nashorn:mozilla_compat.js");</code>.</p>
+
+<p>Starting with Java 15 Nashorn has been removed again and you need
+  to provide an external JavaScript engine. Your best option probably
+  is <a href="https://github.com/graalvm/graaljs">GraalVM
+  JavaScript</a> which requires you to add a lot of extra jars. For
+  GraalVM JavaScript 20.1 you'll
+  need <code>org.graalvm.js:js</code>, <code>org.graalvm.js:js-engine</code>
+  which in turn
+  require <code>org.graalvm.regex:regex</code>, <code>org.graalvm.truffle:truffle-api</code>, <code>org.graalvm.sdk:graal-sdk</code>,
+  and <code>com.ibm.icu:icu4j</code>. GraalVM JavaScript is not a
+  drop-in replacement for Nashorn, see
+  Graal's <a href="https://github.com/graalvm/graaljs/blob/master/docs/user/NashornMigrationGuide.md">Nashorn
+  Migration Guide</a> for more details.</p>
+
+<p>When using GraalVM JavaScript Ant will enable the
+  feature <code>polyglot.js.allowAllAccess</code> in order to allow
+  scripts to use Ant objects. By default it will also enable Nashorn
+  compatibility mode, but you can disable this by setting the magic
+  Ant property <code>ant.disable.graal.nashorn.compat</code>
+  to <code>true</code>.</p>
+
 <p>The <code>&lt;script&gt;</code> task populates the Project instance under the
 name <code class="code">project</code>, so we can use that reference. Another way is to use its
 given name or getting its reference from the task itself. The Project provides methods for accessing

Modified: ant/site/ant/production/manual/Types/dirset.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/dirset.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/dirset.html (original)
+++ ant/site/ant/production/manual/Types/dirset.html Wed Sep 30 16:34:48 2020
@@ -88,6 +88,14 @@ makes a DirSet equivalent to an <code>&l
       1.7.1</em></td>
     <td>No; defaults to true (for backward compatibility reasons)</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>dirset</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>dirset</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h4>Examples</h4>

Modified: ant/site/ant/production/manual/Types/extension.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/extension.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/extension.html (original)
+++ ant/site/ant/production/manual/Types/extension.html Wed Sep 30 16:34:48 2020
@@ -79,6 +79,14 @@ target="_top">Package Versioning documen
     <td>The url from which to retrieve extension.</td>
     <td>no</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>extension</code>
+      a <a href="../using.html#references">reference</a> to
+      an <code>extension</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h4>Examples</h4>

Modified: ant/site/ant/production/manual/Types/extensionset.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/extensionset.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/extensionset.html (original)
+++ ant/site/ant/production/manual/Types/extensionset.html Wed Sep 30 16:34:48 2020
@@ -31,6 +31,12 @@ file <samp>guide/extensions/versioning.h
 at <a href="https://docs.oracle.com/javase/8/docs/technotes/guides/versioning/spec/versioning2.html#wp90779"
 target="_top">Package Versioning documentation.</a></p>
 
+<p>The only supported attribute is <code>refid</code> which makes this
+  <code>extensionset</code>
+  a <a href="../using.html#references">reference</a> to
+  an <code>extensionset</code> defined elsewhere. If specified no
+  other attributes or nested elements are allowed.</p>
+
 <h3>Nested elements</h3>
 
 <h4>extension</h4>

Modified: ant/site/ant/production/manual/Types/filelist.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/filelist.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/filelist.html (original)
+++ ant/site/ant/production/manual/Types/filelist.html Wed Sep 30 16:34:48 2020
@@ -49,6 +49,14 @@ support this feature or as stand-alone t
     commas.</td>
     <td>Yes, unless there is a nested file element</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>filelist</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>filelist</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h4>Nested element: file</h4>
 <p><em>Since Apache Ant 1.6.2</em></p>

Modified: ant/site/ant/production/manual/Types/fileset.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/fileset.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/fileset.html (original)
+++ ant/site/ant/production/manual/Types/fileset.html Wed Sep 30 16:34:48 2020
@@ -99,6 +99,14 @@ makes a FileSet equivalent to an <code>&
     </td>
     <td>No; defaults to <q>true</q> (for backward compatibility reasons)</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>fileset</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>fileset</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <p id="symlink"><strong>Note</strong>: All files/directories for which the canonical path is

Modified: ant/site/ant/production/manual/Types/filterchain.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/filterchain.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/filterchain.html (original)
+++ ant/site/ant/production/manual/Types/filterchain.html Wed Sep 30 16:34:48 2020
@@ -83,6 +83,12 @@ also.</p>
   &lt;/filterchain&gt;
 &lt;/loadfile&gt;</pre>
 
+<p>The only supported attribute is <code>refid</code> which makes this
+  <code>filterchain</code>
+  a <a href="../using.html#references">reference</a> to
+  a <code>filterchain</code> defined elsewhere. If specified no other
+  attributes or nested elements are allowed.</p>
+
 <p>The following built-in tasks support nested <code>&lt;filterchain&gt;</code> elements.<br/>
 <a href="../Tasks/concat.html">Concat</a>,<br/>
 <a href="../Tasks/copy.html">Copy</a>,<br/>

Modified: ant/site/ant/production/manual/Types/filterset.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/filterset.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/filterset.html (original)
+++ ant/site/ant/production/manual/Types/filterset.html Wed Sep 30 16:34:48 2020
@@ -91,6 +91,14 @@ being filtered are all text files.</p>
     <td><q>fail</q></td>
     <td>No</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>filterset</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>filterset</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h3>Filter</h3>

Modified: ant/site/ant/production/manual/Types/mapper.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/mapper.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/mapper.html (original)
+++ ant/site/ant/production/manual/Types/mapper.html Wed Sep 30 16:34:48 2020
@@ -75,6 +75,14 @@ attributes:</p>
     <td>the <code>to</code> attribute for the given implementation.</td>
     <td>Depends on implementation</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>mapper</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>mapper</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <p>Note that Ant will not automatically convert <q>/</q> or <q>\</q> characters in the <var>to</var>
 and <var>from</var> attributes to the correct directory separator of your current platform.  If you

Modified: ant/site/ant/production/manual/Types/patternset.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/patternset.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/patternset.html (original)
+++ ant/site/ant/production/manual/Types/patternset.html Wed Sep 30 16:34:48 2020
@@ -65,6 +65,14 @@ or <code>&lt;exclude&gt;</code> elements
       elements.</td>
     <td>See <var>excludes</var></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>patternset</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>patternset</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h3>Parameters specified as nested elements</h3>
 <h4><code>include</code> and <code>exclude</code></h4>

Modified: ant/site/ant/production/manual/Types/propertyset.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/propertyset.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/propertyset.html (original)
+++ ant/site/ant/production/manual/Types/propertyset.html Wed Sep 30 16:34:48 2020
@@ -47,6 +47,14 @@
     </td>
     <td>No; default is <q>false</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>propertyset</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>propertyset</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h3>Parameters specified as nested elements</h3>
 

Modified: ant/site/ant/production/manual/Types/regexp.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/regexp.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/regexp.html (original)
+++ ant/site/ant/production/manual/Types/regexp.html Wed Sep 30 16:34:48 2020
@@ -39,6 +39,14 @@ Regexp represents a regular expression.
     <td>regular expression pattern</td>
     <td>Yes</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>regexp</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>regexp</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h3>Examples</h3>

Modified: ant/site/ant/production/manual/Types/resources.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/resources.html?rev=1882159&r1=1882158&r2=1882159&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/resources.html (original)
+++ ant/site/ant/production/manual/Types/resources.html Wed Sep 30 16:34:48 2020
@@ -92,6 +92,14 @@ collections</a>.
     <td>The size of this resource</td>
     <td>No</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>resource</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>resource</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h4 id="file">file</h4>
@@ -115,6 +123,14 @@ collections</a>.
       name of the resource will yield a path relative to this location.</td>
     <td>No</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>file</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>file</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h4 id="javaresource">javaresource</h4>
@@ -157,6 +173,14 @@ collections</a>.
       <em>Since Ant 1.8.0</em></td>
     <td>No; defaults to <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>javaresource</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>javaresource</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <p>The classpath can also be specified as nested classpath element,
@@ -181,6 +205,14 @@ loaded.</p>
       field name.</td>
     <td>Yes</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>javaconstant</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>javaconstant</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h5>Examples</h5>
 <p>This loads the value of the constant <code>VERSION</code> of the <code>org.acme.Main</code>
@@ -234,6 +266,14 @@ file system resources as nested elements
     <td>The encoding of the zipfile</td>
     <td>No; defaults to default JVM character encoding</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>propertyresource</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>propertyresource</code> defined elsewhere. If specified
+      no other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h4 id="tarentry">tarentry</h4>
@@ -313,6 +353,14 @@ more information.</p>
       <var>baseUrl</var></td>
     <td>If using <var>baseUrl</var></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>url</code>
+      a <a href="../using.html#references">reference</a> to
+      an <code>url</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h4 id="string">string</h4>
@@ -331,6 +379,14 @@ error to write to again.</p>
     <td>The value of this resource</td>
     <td>No</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>string</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>string</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <p>The resource also supports nested text, which can only be supplied if the <var>value</var>
@@ -442,6 +498,15 @@ duplicate resources (contrast with <a hr
       <td>Whether to cache results.  <em>since Ant 1.8.0</em></td>
       <td>No; default <q>false</q></td>
     </tr>
+    <tr>
+      <td>refid</td>
+      <td>Makes this <code>resourcecollection</code>
+        a <a href="../using.html#references">reference</a> to
+        a <code>resourcecollection</code> defined elsewhere. If
+        specified no other attributes or nested elements are
+        allowed.</td>
+      <td>No</td>
+    </tr>
   </table>
 
 <h4 id="files">files</h4>
@@ -508,6 +573,14 @@ selection.
     <td>Whether to follow symbolic links (see note <a href="#symlink">below</a>)</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>files</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>files</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <p id="symlink"><a href="#followsymlinks"><strong>Note</strong></a>: All files/directories for which
@@ -529,6 +602,14 @@ platforms.</p>
       may seriously impact performance</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>restrict</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>restrict</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h5>Parameters specified as nested elements</h5>
 <p>A single resource collection is required.</p>
@@ -831,6 +912,14 @@ more nested <a href="#rcmp">resource com
     <td>Whether to cache results; disabling may seriously impact performance</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>sort</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>sort</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h5>Parameters specified as nested elements</h5>
 <p>A single resource collection is required.</p>
@@ -933,6 +1022,14 @@ first few oldest, largest, etc. resource
     <td>Whether to cache results; disabling may seriously impact performance</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>first</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>first</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h5>Parameters specified as nested elements</h5>
 <p>A single resource collection is required.</p>
@@ -958,6 +1055,14 @@ last few oldest, largest, etc. resources
     <td>Whether to cache results; disabling may seriously impact performance</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>last</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>last</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h5>Parameters specified as nested elements</h5>
 <p>A single resource collection is required.</p>
@@ -984,6 +1089,14 @@ collection.</p>
     <td>Whether to cache results; disabling may seriously impact performance</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>allbutfirst</code>
+      a <a href="../using.html#references">reference</a> to
+      an <code>allbutfirst</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h5>Parameters specified as nested elements</h5>
 <p>A single resource collection is required.</p>
@@ -1010,6 +1123,14 @@ collection.</p>
     <td>Whether to cache results; disabling may seriously impact performance</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>allbutlast</code>
+      a <a href="../using.html#references">reference</a> to
+      an <code>allbutlast</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h5>Parameters specified as nested elements</h5>
 <p>A single resource collection is required.</p>
@@ -1036,6 +1157,14 @@ collection can implement equivalents for
     <td>Whether to cache results; disabling may seriously impact performance</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>tokens</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>tokens</code> defined elsewhere. If specified no other
+      attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 <h5>Parameters specified as nested elements</h5>
 <ul>
@@ -1069,9 +1198,21 @@ collection can implement equivalents for
 <h4 id="union">union</h4>
 <p>Union of nested resource collections.</p>
 
+<p>The only supported attribute is <code>refid</code> which makes this
+  <code>union</code>
+  a <a href="../using.html#references">reference</a> to
+  an <code>union</code> defined elsewhere. If specified no other
+  attributes or nested elements are allowed.</p>
+
 <h4 id="intersect">intersect</h4>
 <p>Intersection of nested resource collections.</p>
 
+<p>The only supported attribute is <code>refid</code> which makes this
+  <code>intersect</code>
+  a <a href="../using.html#references">reference</a> to
+  an <code>intersect</code> defined elsewhere. If specified no other
+  attributes or nested elements are allowed.</p>
+
 <h4 id="difference">difference</h4>
 <p>Difference of nested resource collections.</p>
 
@@ -1087,6 +1228,14 @@ collection can implement equivalents for
     <td>Whether to cache results; disabling may seriously impact performance</td>
     <td>No; default <q>true</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>difference</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>difference</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h5>Examples</h5>
@@ -1144,6 +1293,14 @@ resources.</p>
       <em>since Ant 1.8.1</em></td>
     <td>No; defaults to <q>false</q></td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>mappedresources</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>mappedresources</code> defined elsewhere. If specified
+      no other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h5>Parameters specified as nested elements</h5>
@@ -1194,7 +1351,11 @@ by <code>&lt;archives&gt;</code> are the
 of <a href="../Tasks/zip.html#zipgroupfileset">zipgroupfileset</a> which is only supported by
 the zip family of tasks.</p>
 
-<p><code>archives</code> doesn't support any attributes.</p>
+<p>The only supported attribute is <code>refid</code> which makes this
+  <code>archives</code>
+  a <a href="../using.html#references">reference</a> to
+  an <code>archives</code> defined elsewhere. If specified no other
+  attributes or nested elements are allowed.</p>
 
 <h5>Parameters specified as nested elements</h5>
 
@@ -1258,6 +1419,14 @@ of <a href="filelist.html"><code>&lt;fil
     </td>
     <td>No</td>
   </tr>
+  <tr>
+    <td>refid</td>
+    <td>Makes this <code>resourcelist</code>
+      a <a href="../using.html#references">reference</a> to
+      a <code>resourcelist</code> defined elsewhere. If specified no
+      other attributes or nested elements are allowed.</td>
+    <td>No</td>
+  </tr>
 </table>
 
 <h5>Parameters specified as nested elements</h5>