ant-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From anto...@apache.org
Subject svn commit: r1485180 - in /ant/site/ant/production/manual: ./ Tasks/ Types/
Date Wed, 22 May 2013 12:21:12 GMT
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>&lt;wljspc&gt;</code> task 
 (it may), concurrency problems may arise.
 </p>
 
-<taskdef name=""
 <pre>
  &lt;macrodef name="dbpurge"&gt;
     &lt;attribute file="file"/&gt;
@@ -208,7 +207,7 @@ if the <code>&lt;wljspc&gt;</code> task 
    &lt;/sequential&gt;
 &lt;/macrodef&gt;
     
-&lt;parallel threadCount='4'&gt;
+&lt;parallel threadCount="4"&gt;
   &lt;dbpurge file="db/one" /&gt;
   &lt;dbpurge file="db/two" /&gt;
   &lt;dbpurge file="db/three" /&gt;

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 &#64;DATE&#64; 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>
 &lt;tstamp/&gt;
+&lt;!-- just for explaining the use of the properties --&gt;
+&lt;property name=&quot;src.file&quot; value=&quot;orders.csv&quot;/&gt;
+&lt;property name=&quot;src.file.replaced&quot; value=&quot;orders.replaced&quot;/&gt;
+
+&lt;!-- do the loading and filtering --&gt;
 &lt;loadfile srcfile=&quot;${src.file}&quot; property=&quot;${src.file.replaced}&quot;&gt;
   &lt;filterchain&gt;
     &lt;filterreader classname=&quot;org.apache.tools.ant.filters.ReplaceTokens&quot;&gt;
@@ -594,6 +600,9 @@ with today's date and stores it in the p
     &lt;/filterreader&gt;
   &lt;/filterchain&gt;
 &lt;/loadfile&gt;
+
+&lt;!-- just for explaining the use of the properties --&gt;
+&lt;echo message=&quot;${orders.replaced}&quot;/>
 </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&trade; 1.9.0 Manual</h1>
-  <p align="left">This is the manual for version 1.9.0 of 
+  <h1>Apache Ant&trade; 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>



Mime
View raw message