You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ant.apache.org by an...@apache.org on 2013/05/22 14:21:12 UTC
svn commit: r1485180 - in /ant/site/ant/production/manual: ./ Tasks/ Types/
Author: antoine
Date: Wed May 22 12:21:11 2013
New Revision: 1485180
URL: http://svn.apache.org/r1485180
Log:
updating manual on web site to 1.9.1
Added:
ant/site/ant/production/manual/Tasks/verifyjar.html
- copied unchanged from r1483158, ant/core/trunk/manual/Tasks/verifyjar.html
ant/site/ant/production/manual/ifunless.html
- copied unchanged from r1483158, ant/core/trunk/manual/ifunless.html
Modified:
ant/site/ant/production/manual/ (props changed)
ant/site/ant/production/manual/Tasks/ear.html
ant/site/ant/production/manual/Tasks/echoxml.html
ant/site/ant/production/manual/Tasks/include.html (props changed)
ant/site/ant/production/manual/Tasks/jar.html
ant/site/ant/production/manual/Tasks/parallel.html
ant/site/ant/production/manual/Tasks/signjar.html
ant/site/ant/production/manual/Tasks/war.html
ant/site/ant/production/manual/Tasks/zip.html
ant/site/ant/production/manual/Types/filterchain.html
ant/site/ant/production/manual/Types/namespace.html
ant/site/ant/production/manual/conceptstypeslist.html
ant/site/ant/production/manual/cover.html
ant/site/ant/production/manual/credits.html
ant/site/ant/production/manual/install.html
ant/site/ant/production/manual/tasklist.html
Propchange: ant/site/ant/production/manual/
------------------------------------------------------------------------------
--- svn:mergeinfo (added)
+++ svn:mergeinfo Wed May 22 12:21:11 2013
@@ -0,0 +1,2 @@
+/ant/core/tags/ANT_191/manual:1483159-1485178
+/ant/core/trunk/manual:1453159-1483158
Modified: ant/site/ant/production/manual/Tasks/ear.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/ear.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/ear.html (original)
+++ ant/site/ant/production/manual/Tasks/ear.html Wed May 22 12:21:11 2013
@@ -227,7 +227,7 @@ to a value other than its default, <code
<td valign="top">createUnicodeExtraFields</td>
<td valign="top">Whether to create unicode extra fields to store
the file names a second time inside the entry's metadata.
- <br>Possible values are "never", "always" and "not-encodable"
+ <br>Possible values are "never", "always" and "not-encodeable"
which will only add Unicode extra fields if the file name cannot
be encoded using the specified encoding.
<em>Since Ant 1.8.0</em>.
@@ -264,6 +264,15 @@ to a value other than its default, <code
<em>Since Ant 1.8.0</em>.</td>
<td align="center" valign="top">No, default is false</td>
</tr>
+ <tr>
+ <td valign="top">zip64Mode</td>
+ <td valign="top">When to use Zip64 extensions for entries. The
+ possible values are "never", "always" and "as-needed".
+ <em>Since Ant 1.9.1</em>.
+ <br/>See also the <a href="zip.html#zip64">discussion in the
+ zip task page</a></td>
+ <td align="center" valign="top">No, default is "never"</td>
+ </tr>
</table>
<h3>Nested elements</h3>
Modified: ant/site/ant/production/manual/Tasks/echoxml.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/echoxml.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/echoxml.html (original)
+++ ant/site/ant/production/manual/Tasks/echoxml.html Wed May 22 12:21:11 2013
@@ -48,10 +48,11 @@
<tr>
<td valign="top">namespacePolicy</td>
<td valign="top">Sets the namespace policy as defined
- by <code>org.apache.tools.ant.util.DOMElementWriter.XmlNamespacePolicy</code>. Valid
- values are "ignore," "elementsOnly," or "all." Default is
- "ignore".</td>
- <td valign="top" align="center">No</td>
+ by <code>org.apache.tools.ant.util.DOMElementWriter.XmlNamespacePolicy</code>.
+ Valid values are <code>ignore</code>, <code>elementsOnly</code>, or <code>all</code>.
+ <strong>Since Apache Ant 1.8</strong>
+ </td>
+ <td valign="top" align="center">No, default <code>ignore</code></td>
</tr>
</table>
<h3>Parameters specified as nested elements</h3>
Propchange: ant/site/ant/production/manual/Tasks/include.html
------------------------------------------------------------------------------
Merged /ant/core/tags/ANT_191/manual/Tasks/include.html:r1483159-1485178
Merged /ant/core/trunk/manual/Tasks/include.html:r1453159-1483158
Modified: ant/site/ant/production/manual/Tasks/jar.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/jar.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/jar.html (original)
+++ ant/site/ant/production/manual/Tasks/jar.html Wed May 22 12:21:11 2013
@@ -283,7 +283,7 @@ to a value other than its default, <code
<td valign="top">createUnicodeExtraFields</td>
<td valign="top">Whether to create unicode extra fields to store
the file names a second time inside the entry's metadata.
- <br>Possible values are "never", "always" and "not-encodable"
+ <br>Possible values are "never", "always" and "not-encodeable"
which will only add Unicode extra fields if the file name cannot
be encoded using the specified encoding.
<em>Since Ant 1.8.0</em>.
@@ -320,6 +320,15 @@ to a value other than its default, <code
<em>Since Ant 1.8.0</em>.</td>
<td align="center" valign="top">No, default is false</td>
</tr>
+ <tr>
+ <td valign="top">zip64Mode</td>
+ <td valign="top">When to use Zip64 extensions for entries. The
+ possible values are "never", "always" and "as-needed".
+ <em>Since Ant 1.9.1</em>.
+ <br/>See also the <a href="zip.html#zip64">discussion in the
+ zip task page</a></td>
+ <td align="center" valign="top">No, default is "never"</td>
+ </tr>
</table>
<h3>Nested elements</h3>
Modified: ant/site/ant/production/manual/Tasks/parallel.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/parallel.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/parallel.html (original)
+++ ant/site/ant/production/manual/Tasks/parallel.html Wed May 22 12:21:11 2013
@@ -197,7 +197,6 @@ if the <code><wljspc></code> task
(it may), concurrency problems may arise.
</p>
-<taskdef name=""
<pre>
<macrodef name="dbpurge">
<attribute file="file"/>
@@ -208,7 +207,7 @@ if the <code><wljspc></code> task
</sequential>
</macrodef>
-<parallel threadCount='4'>
+<parallel threadCount="4">
<dbpurge file="db/one" />
<dbpurge file="db/two" />
<dbpurge file="db/three" />
Modified: ant/site/ant/production/manual/Tasks/signjar.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/signjar.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/signjar.html (original)
+++ ant/site/ant/production/manual/Tasks/signjar.html Wed May 22 12:21:11 2013
@@ -100,6 +100,11 @@ and <tt>lazy</tt> is false, the JAR is s
<td valign="top" align="center">No; default false</td>
</tr>
<tr>
+ <td valign="top">strict</td>
+ <td valign="top">(true | false) strict checking when signing.<br/><em>since Ant 1.9.1</em>.</td>
+ <td valign="top" align="center">No; default false</td>
+ </tr>
+ <tr>
<td valign="top">internalsf</td>
<td valign="top">(true | false) include the .SF file inside the signature
block</td>
Modified: ant/site/ant/production/manual/Tasks/war.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/war.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/war.html (original)
+++ ant/site/ant/production/manual/Tasks/war.html Wed May 22 12:21:11 2013
@@ -230,7 +230,7 @@ to a value other than its default, <code
<td valign="top">createUnicodeExtraFields</td>
<td valign="top">Whether to create unicode extra fields to store
the file names a second time inside the entry's metadata.
- <br>Possible values are "never", "always" and "not-encodable"
+ <br>Possible values are "never", "always" and "not-encodeable"
which will only add Unicode extra fields if the file name cannot
be encoded using the specified encoding.
<em>Since Ant 1.8.0</em>.
@@ -267,6 +267,15 @@ to a value other than its default, <code
<em>Since Ant 1.8.0</em>.</td>
<td align="center" valign="top">No, default is false</td>
</tr>
+ <tr>
+ <td valign="top">zip64Mode</td>
+ <td valign="top">When to use Zip64 extensions for entries. The
+ possible values are "never", "always" and "as-needed".
+ <em>Since Ant 1.9.1</em>.
+ <br/>See also the <a href="zip.html#zip64">discussion in the
+ zip task page</a></td>
+ <td align="center" valign="top">No, default is "never"</td>
+ </tr>
</table>
<h3>Nested elements</h3>
Modified: ant/site/ant/production/manual/Tasks/zip.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Tasks/zip.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Tasks/zip.html (original)
+++ ant/site/ant/production/manual/Tasks/zip.html Wed May 22 12:21:11 2013
@@ -256,7 +256,7 @@ archive.</p>
<td valign="top">createUnicodeExtraFields</td>
<td valign="top">Whether to create unicode extra fields to store
the file names a second time inside the entry's metadata.
- <br>Possible values are "never", "always" and "not-encodable"
+ <br>Possible values are "never", "always" and "not-encodeable"
which will only add Unicode extra fields if the file name cannot
be encoded using the specified encoding.
<em>Since Ant 1.8.0</em>.
@@ -272,6 +272,14 @@ archive.</p>
<br/>See also the <a href="#encoding">discussion below</a></td>
<td align="center" valign="top">No, default is false</td>
</tr>
+ <tr>
+ <td valign="top">zip64Mode</td>
+ <td valign="top">When to use Zip64 extensions for entries. The
+ possible values are "never", "always" and "as-needed".
+ <em>Since Ant 1.9.1</em>.
+ <br/>See also the <a href="#zip64">discussion below</a></td>
+ <td align="center" valign="top">No, default is "as-needed"</td>
+ </tr>
</table>
<h3><a name="encoding">Encoding of File Names</a></h3>
@@ -390,6 +398,50 @@ archive.</p>
so the tools that support them will extract the file names
correctly.</p>
+<h3><a name="zip64">Zip64 extensions</a></h3>
+
+<p>Zip64 extensions provide a way to create archives bigger than 4GB
+ or holding more than 65535 entries - or add individual entries
+ bigger than 4GB using the ZIP extension field mechanism. These
+ extensions are supported by most modern ZIP implementations.</p>
+
+<p>When Ant writes compressed entries into the archive it creates it
+ doesn't know the compressed size of an entry before it has been
+ written. Unfortunately the decision whether a Zip64 extra field
+ will be written has to be made before writing the entry's
+ content.</p>
+
+<p>Starting with Ant 1.9.0 Ant supports Zip64 extensions but didn't
+ provide any control over their usage, starting with Ant 1.9.1 a
+ new <em>zip64mode</em> attribute was added to the <code>zip</code>
+ family of tasks. It supports three values:
+
+<ul>
+ <li><em>never</em> means no Zip64 extra fields will ever be
+ written, this is the behavior of Ant 1.8.x and earlier and the
+ default behavior of <code>jar</code>, <code>ear</code>
+ and <code>war</code> starting with Ant 1.9.1.</li>
+ <li><em>always</em> means Zip64 extra fields are written for all
+ entries.</li>
+ <li><em>as-needed</em> means Zip64 extra fields are written for all
+ compressed entries to the "local file header" (by default these
+ are all files but not the directories) but only written to the
+ central directory if the entry really required Zip64 features.
+ This is the default behavior of Ant 1.9.0 and remains the default
+ behavior of the <code>zip</code> task.</li>
+</ul>
+
+<p><em>as-needed</em> provides a good compromise if you don't know
+ whether you archive will exceed the limits of traditional zip files
+ but don't want to waste too much space (the Zip64 extensions take up
+ extra space). Unfortunately some ZIP implementations don't
+ understand Zip64 extra fields or fail to parse archives with extra
+ fields in local file headers that are not present in the central
+ directory, one such implementation is the java.util.zip package of
+ Java5, that's why the <code>jar</code> tasks default
+ to <em>never</em>. Archives created with <em>as-needed</em> can be
+ read without problems with Java6 and later.</p>
+
<h3>Parameters specified as nested elements</h3>
<h4>any resource collection</h4>
Modified: ant/site/ant/production/manual/Types/filterchain.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/filterchain.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/filterchain.html (original)
+++ ant/site/ant/production/manual/Types/filterchain.html Wed May 22 12:21:11 2013
@@ -102,6 +102,7 @@ The following built-in tasks support nes
<a href="../Tasks/copy.html">Copy</a>,<br>
<a href="../Tasks/loadfile.html">LoadFile</a>,<br>
<a href="../Tasks/loadproperties.html">LoadProperties</a>,<br>
+<a href="../Tasks/loadresource.html">LoadResource</a>,<br>
<a href="../Tasks/move.html">Move</a><br><br>
A FilterChain is formed by defining zero or more of the following
@@ -584,9 +585,14 @@ user defined values.
<h4>Example:</h4>
This replaces occurrences of the string @DATE@ in the data
-with today's date and stores it in the property ${src.file.replaced}
+with today's date and stores it in the property ${src.file.replaced}.
<blockquote><pre>
<tstamp/>
+<!-- just for explaining the use of the properties -->
+<property name="src.file" value="orders.csv"/>
+<property name="src.file.replaced" value="orders.replaced"/>
+
+<!-- do the loading and filtering -->
<loadfile srcfile="${src.file}" property="${src.file.replaced}">
<filterchain>
<filterreader classname="org.apache.tools.ant.filters.ReplaceTokens">
@@ -594,6 +600,9 @@ with today's date and stores it in the p
</filterreader>
</filterchain>
</loadfile>
+
+<!-- just for explaining the use of the properties -->
+<echo message="${orders.replaced}"/>
</pre></blockquote>
Convenience method:
Modified: ant/site/ant/production/manual/Types/namespace.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/namespace.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/namespace.html (original)
+++ ant/site/ant/production/manual/Types/namespace.html Wed May 22 12:21:11 2013
@@ -152,6 +152,10 @@
</li>
</ul>
<p>
+ In Ant 1.9.1 two attribute namespaces ant:if and ant:unless are added in order to allow to insert elements
+ conditionally
+ </p>
+ <p>
Other attributes are simply ignored.
</p>
<p>
Modified: ant/site/ant/production/manual/conceptstypeslist.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/conceptstypeslist.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/conceptstypeslist.html (original)
+++ ant/site/ant/production/manual/conceptstypeslist.html Wed May 22 12:21:11 2013
@@ -35,6 +35,7 @@
<li><a href="sysclasspath.html">build.sysclasspath</a></li>
<li><a href="javacprops.html">Ant properties controlling javac</a></li>
<li><a href="Tasks/common.html">Common Attributes</a></li>
+<li><a href="ifunless.html">If and Unless Attributes</a></li>
</ul>
<h3>List of Types</h3>
Modified: ant/site/ant/production/manual/cover.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/cover.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/cover.html (original)
+++ ant/site/ant/production/manual/cover.html Wed May 22 12:21:11 2013
@@ -19,14 +19,14 @@
<head>
<meta http-equiv="Content-Language" content="en-us">
<link rel="stylesheet" type="text/css" href="stylesheets/style.css">
-<title>Apache Ant 1.9.0 User Manual</title>
+<title>Apache Ant 1.9.1 User Manual</title>
</head>
<body bgcolor="#FFFFFF">
<div align="center">
<h1><img src="images/ant_logo_large.gif" width="190" height="120"></h1>
- <h1>Apache Ant™ 1.9.0 Manual</h1>
- <p align="left">This is the manual for version 1.9.0 of
+ <h1>Apache Ant™ 1.9.1 Manual</h1>
+ <p align="left">This is the manual for version 1.9.1 of
<a target="_top" href="http://ant.apache.org/index.html">Apache Ant</a>.
If your version
of Ant (as verified with <tt>ant -version</tt>) is older or newer than this
Modified: ant/site/ant/production/manual/credits.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/credits.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/credits.html (original)
+++ ant/site/ant/production/manual/credits.html Wed May 22 12:21:11 2013
@@ -62,7 +62,7 @@
</ul>
<center>
-<p>Version: 1.9.0</p>
+<p>Version: 1.9.1</p>
</center>
Modified: ant/site/ant/production/manual/install.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/install.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/install.html (original)
+++ ant/site/ant/production/manual/install.html Wed May 22 12:21:11 2013
@@ -1008,7 +1008,7 @@ you need jakarta-oro 2.0.8 or later, and
target="_top">http://xml.apache.org/commons/</a>.</td>
</tr>
<tr>
- <td>jsch.jar <b>0.1.42 or later</b></td>
+ <td>jsch.jar <b>0.1.50 or later</b></td>
<td>sshexec and scp tasks</td>
<td><a href="http://www.jcraft.com/jsch/index.html"
target="_top">http://www.jcraft.com/jsch/index.html</a></td>
Modified: ant/site/ant/production/manual/tasklist.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/tasklist.html?rev=1485180&r1=1485179&r2=1485180&view=diff
==============================================================================
--- ant/site/ant/production/manual/tasklist.html (original)
+++ ant/site/ant/production/manual/tasklist.html Wed May 22 12:21:11 2013
@@ -180,6 +180,7 @@
<li><a href="Tasks/unzip.html">Unwar</a></li>
<li><a href="Tasks/unzip.html">Unzip</a></li>
<li><a href="Tasks/uptodate.html">Uptodate</a></li>
+<li><a href="Tasks/verifyjar.html">VerifyJar</a></li>
<li><a href="Tasks/vss.html#tasks">Microsoft Visual SourceSafe Tasks</a></li>
<li><a href="Tasks/waitfor.html">Waitfor</a></li>
<li><a href="Tasks/war.html">War</a></li>