Return-Path: X-Original-To: apmail-ant-notifications-archive@minotaur.apache.org Delivered-To: apmail-ant-notifications-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 4D2C7D3A0 for ; Wed, 22 May 2013 12:21:37 +0000 (UTC) Received: (qmail 41028 invoked by uid 500); 22 May 2013 12:21:37 -0000 Delivered-To: apmail-ant-notifications-archive@ant.apache.org Received: (qmail 40927 invoked by uid 500); 22 May 2013 12:21:36 -0000 Mailing-List: contact notifications-help@ant.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@ant.apache.org Delivered-To: mailing list notifications@ant.apache.org Received: (qmail 40900 invoked by uid 99); 22 May 2013 12:21:35 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 22 May 2013 12:21:35 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 22 May 2013 12:21:33 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 2A48923888E3 for ; Wed, 22 May 2013 12:21:13 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1485180 - in /ant/site/ant/production/manual: ./ Tasks/ Types/ Date: Wed, 22 May 2013 12:21:12 -0000 To: notifications@ant.apache.org From: antoine@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20130522122113.2A48923888E3@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org 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, createUnicodeExtraFields Whether to create unicode extra fields to store the file names a second time inside the entry's metadata. -
Possible values are "never", "always" and "not-encodable" +
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. Since Ant 1.8.0. @@ -264,6 +264,15 @@ to a value other than its default, Since Ant 1.8.0. No, default is false + + zip64Mode + When to use Zip64 extensions for entries. The + possible values are "never", "always" and "as-needed". + Since Ant 1.9.1. +
See also the discussion in the + zip task page + No, default is "never" +

Nested elements

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 @@ namespacePolicy Sets the namespace policy as defined - by org.apache.tools.ant.util.DOMElementWriter.XmlNamespacePolicy. Valid - values are "ignore," "elementsOnly," or "all." Default is - "ignore". - No + by org.apache.tools.ant.util.DOMElementWriter.XmlNamespacePolicy. + Valid values are ignore, elementsOnly, or all. + Since Apache Ant 1.8 + + No, default ignore

Parameters specified as nested elements

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, createUnicodeExtraFields Whether to create unicode extra fields to store the file names a second time inside the entry's metadata. -
Possible values are "never", "always" and "not-encodable" +
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. Since Ant 1.8.0. @@ -320,6 +320,15 @@ to a value other than its default, Since Ant 1.8.0. No, default is false + + zip64Mode + When to use Zip64 extensions for entries. The + possible values are "never", "always" and "as-needed". + Since Ant 1.9.1. +
See also the discussion in the + zip task page + No, default is "never" +

Nested elements

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 <wljspc> task (it may), concurrency problems may arise.

- <macrodef name="dbpurge"> <attribute file="file"/> @@ -208,7 +207,7 @@ if the <wljspc> 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 lazy is false, the JAR is s No; default false + strict + (true | false) strict checking when signing.
since Ant 1.9.1. + No; default false + + internalsf (true | false) include the .SF file inside the signature block 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, createUnicodeExtraFields Whether to create unicode extra fields to store the file names a second time inside the entry's metadata. -
Possible values are "never", "always" and "not-encodable" +
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. Since Ant 1.8.0. @@ -267,6 +267,15 @@ to a value other than its default, Since Ant 1.8.0. No, default is false + + zip64Mode + When to use Zip64 extensions for entries. The + possible values are "never", "always" and "as-needed". + Since Ant 1.9.1. +
See also the discussion in the + zip task page + No, default is "never" +

Nested elements

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.

createUnicodeExtraFields Whether to create unicode extra fields to store the file names a second time inside the entry's metadata. -
Possible values are "never", "always" and "not-encodable" +
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. Since Ant 1.8.0. @@ -272,6 +272,14 @@ archive.


See also the discussion below No, default is false + + zip64Mode + When to use Zip64 extensions for entries. The + possible values are "never", "always" and "as-needed". + Since Ant 1.9.1. +
See also the discussion below + No, default is "as-needed" +

Encoding of File Names

@@ -390,6 +398,50 @@ archive.

so the tools that support them will extract the file names correctly.

+

Zip64 extensions

+ +

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.

+ +

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.

+ +

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 zip64mode attribute was added to the zip + family of tasks. It supports three values: + +

    +
  • never 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 jar, ear + and war starting with Ant 1.9.1.
    • +
  • always means Zip64 extra fields are written for all + entries.
    • +
  • as-needed 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 zip task.
    • +
+ +

as-needed 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 jar tasks default + to never. Archives created with as-needed can be + read without problems with Java6 and later.

+

Parameters specified as nested elements

any resource collection

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 Copy,
LoadFile,
LoadProperties,
+LoadResource,
Move

A FilterChain is formed by defining zero or more of the following @@ -584,9 +585,14 @@ user defined values.

Example:

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}. 
 <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}"/>
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 @@

+ In Ant 1.9.1 two attribute namespaces ant:if and ant:unless are added in order to allow to insert elements + conditionally +

+

Other attributes are simply ignored.

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 @@

  • build.sysclasspath
  • Ant properties controlling javac
  • Common Attributes
    • +
  • If and Unless Attributes

    • List of Types

    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 @@ -Apache Ant 1.9.0 User Manual +Apache Ant 1.9.1 User Manual

    -

    Apache Ant™ 1.9.0 Manual

    -

    This is the manual for version 1.9.0 of +

    Apache Ant™ 1.9.1 Manual

    +

    This is the manual for version 1.9.1 of Apache Ant. If your version of Ant (as verified with ant -version) 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 @@

    -

    Version: 1.9.0

    +

    Version: 1.9.1

    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/. - jsch.jar 0.1.42 or later + jsch.jar 0.1.50 or later sshexec and scp tasks http://www.jcraft.com/jsch/index.html 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 @@
  • Unwar
  • Unzip
  • Uptodate
    • +
  • VerifyJar
  • Microsoft Visual SourceSafe Tasks
  • Waitfor
  • War