ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bode...@apache.org
Subject cvs commit: jakarta-ant/docs/manual/CoreTasks ear.html jar.html war.html zip.html
Date Wed, 22 Aug 2001 17:51:36 GMT
bodewig     01/08/22 10:51:36

  Modified:    docs/manual/CoreTasks Tag: ANT_14_BRANCH ear.html jar.html
                        war.html zip.html
  Log:
  Add documentation for the update attribute of <zip> and friends.
  
  Submitted by:	Jon Skeet <jon.skeet@peramon.com>
  
  Revision  Changes    Path
  No                   revision
  
  
  No                   revision
  
  
  1.4.2.1   +6 -0      jakarta-ant/docs/manual/CoreTasks/ear.html
  
  Index: ear.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/ear.html,v
  retrieving revision 1.4
  retrieving revision 1.4.2.1
  diff -u -r1.4 -r1.4.2.1
  --- ear.html	2001/07/12 07:36:33	1.4
  +++ ear.html	2001/08/22 17:51:36	1.4.2.1
  @@ -92,6 +92,12 @@
       <td valign="top" align="center">No</td>
     </tr>
     <tr>
  +    <td valign="top">update</td>
  +    <td valign="top">indicates whether to update or overwrite
  +      the destination file if it already exists.</td>
  +    <td valign="top" align="center">No</td>
  +  </tr>
  +  <tr>
       <td valign="top">whenempty</td>
       <td valign="top">Behavior to use if no files match.</td>
       <td valign="top" align="center">No</td>
  
  
  
  1.5.2.1   +11 -0     jakarta-ant/docs/manual/CoreTasks/jar.html
  
  Index: jar.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/jar.html,v
  retrieving revision 1.5
  retrieving revision 1.5.2.1
  diff -u -r1.5 -r1.5.2.1
  --- jar.html	2001/07/12 07:36:36	1.5
  +++ jar.html	2001/08/22 17:51:36	1.5.2.1
  @@ -33,6 +33,11 @@
   See the <a href="zip.html">Zip</a> task for more details and examples.</p>
   <p>If the manifest is omitted, a simple one will be supplied by Ant.
   You should not include <samp>META-INF/MANIFEST.MF</samp> in your set of files.</p>
  +<p>The <code>update</code> parameter controls what happens if the
  +JAR file already exists. When set to <code>yes</code>, the JAR file is
  +updated with the files specified. When set to <code>no</code> (the
  +default) the JAR file is overwritten. An example use of this is
  +provided in the <a href="zip.html">Zip task documentation</a>.
   <p>The <code>whenempty</code> parameter controls what happens when no
files match.
   If <code>create</code> (the default), the JAR is created anyway with only a
manifest.
   If <code>skip</code>, the JAR is not created and a warning is issued.
  @@ -111,6 +116,12 @@
     <tr>
       <td valign="top">manifest</td>
       <td valign="top">the manifest file to use.</td>
  +    <td valign="top" align="center">No</td>
  +  </tr>
  +  <tr>
  +    <td valign="top">update</td>
  +    <td valign="top">indicates whether to update or overwrite
  +      the destination file if it already exists.</td>
       <td valign="top" align="center">No</td>
     </tr>
     <tr>
  
  
  
  1.5.2.1   +6 -0      jakarta-ant/docs/manual/CoreTasks/war.html
  
  Index: war.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/war.html,v
  retrieving revision 1.5
  retrieving revision 1.5.2.1
  diff -u -r1.5 -r1.5.2.1
  --- war.html	2001/07/12 07:36:37	1.5
  +++ war.html	2001/08/22 17:51:36	1.5.2.1
  @@ -94,6 +94,12 @@
       <td valign="top" align="center">No</td>
     </tr>
     <tr>
  +    <td valign="top">update</td>
  +    <td valign="top">indicates whether to update or overwrite
  +      the destination file if it already exists.</td>
  +    <td valign="top" align="center">No</td>
  +  </tr>
  +  <tr>
       <td valign="top">whenempty</td>
       <td valign="top">Behavior to use if no files match.</td>
       <td valign="top" align="center">No</td>
  
  
  
  1.4.2.1   +19 -2     jakarta-ant/docs/manual/CoreTasks/zip.html
  
  Index: zip.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/zip.html,v
  retrieving revision 1.4
  retrieving revision 1.4.2.1
  diff -u -r1.4 -r1.4.2.1
  --- zip.html	2001/07/12 07:36:39	1.4
  +++ zip.html	2001/08/22 17:51:36	1.4.2.1
  @@ -33,6 +33,11 @@
   and optional subelements like <code>&lt;include&gt;</code>); explicit
nested
   <code>&lt;fileset&gt;</code> elements so long as at least one fileset
total is specified. The ZIP file will
   only reflect the relative paths of files <i>within</i> each fileset. The Zip
task and its derivatives know a special form of a fileset named zipfileset that has additional
attributes (described below). </p>
  +<p>The <code>update</code> parameter controls what happens if the
  +ZIP file already exists. When set to <code>yes</code>, the ZIP file is
  +updated with the files specified. (New files are added; old files are
  +replaced with the new versions.) When set to <code>no</code> (the
  +default) the ZIP file is overwritten.
   <p>The <code>whenempty</code> parameter controls what happens when no
files match.
   If <code>skip</code> (the default), the ZIP is not created and a warning is
issued.
   If <code>fail</code>, the ZIP is not created and the build is halted with an
error.
  @@ -110,6 +115,12 @@
       <td valign="top" align="center">No</td>
     </tr>
     <tr>
  +    <td valign="top">update</td>
  +    <td valign="top">indicates whether to update or overwrite
  +      the destination file if it already exists.</td>
  +    <td valign="top" align="center">No</td>
  +  </tr>
  +  <tr>
       <td valign="top">whenempty</td>
       <td valign="top">Behavior when no files match.</td>
       <td valign="top" align="center">No</td>
  @@ -138,6 +149,14 @@
   in the <code>${dist}</code> directory.</p>
   <pre>  &lt;zip zipfile=&quot;${dist}/manual.zip&quot;
          basedir=&quot;htdocs/manual&quot;
  +       update=&quot;true&quot;
  +  /&gt;</pre>
  +<p>zips all files in the <code>htdocs/manual</code> directory into a
file called <code>manual.zip</code>
  +in the <code>${dist}</code> directory. If <code>manual.zip</code>
  +doesn't exist, it is created; otherwise it is updated with the
  +new/changed files.</p>
  +<pre>  &lt;zip zipfile=&quot;${dist}/manual.zip&quot;
  +       basedir=&quot;htdocs/manual&quot;
          excludes=&quot;mydocs/**, **/todo.html&quot;
     /&gt;</pre>
   <p>zips all files in the <code>htdocs/manual</code> directory. Files
in the directory <code>mydocs</code>,
  @@ -169,8 +188,6 @@
       docs/ChangeLog.txt
       docs/examples/index.html
   </code></pre>
  -
  -
   <hr>
   <p align="center">Copyright &copy; 2000,2001 Apache Software Foundation. All
rights
   Reserved.</p>
  
  
  

Mime
View raw message