cvs commit: jakarta-ant/docs index.html

[bodewig]

bodewig     00/12/01 07:41:21

  Modified:    .        WHATSNEW
               docs     index.html
  Log:
  Documentation for the nested <srcfile> element of <execon>.
  
  Revision  Changes    Path
  1.60      +4 -0      jakarta-ant/WHATSNEW
  
  Index: WHATSNEW
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/WHATSNEW,v
  retrieving revision 1.59
  retrieving revision 1.60
  diff -u -r1.59 -r1.60
  --- WHATSNEW  2000/12/01 14:06:54     1.59
  +++ WHATSNEW  2000/12/01 15:41:17     1.60
  @@ -37,6 +37,10 @@
     target files for some tasks like <copy> or enable new types of tasks
     like <transform>.
   
  +* <execon> provides more control over the command line now, the names
  +  of the source files are no longer required to be at the end of the
  +  command.
  +
   Fixed bugs:
   -----------
   
  
  
  
  1.163     +19 -1     jakarta-ant/docs/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/index.html,v
  retrieving revision 1.162
  retrieving revision 1.163
  diff -u -r1.162 -r1.163
  --- index.html        2000/12/01 15:27:13     1.162
  +++ index.html        2000/12/01 15:41:20     1.163
  @@ -2171,6 +2171,11 @@
   <p>Command line arguments should be specified as nested
   <code>&lt;arg&gt;</code> elements. See <a
   href="index.html#arg">Command line arguments</a>.</p>
  +<h4>srcfile</h4>
  +<p>By default the file names of the source files will be added to the
  +end of the command line. If you need to place it somewhere different,
  +use a nested <code>&lt;srcfile&gt; element between your
  +<code>&lt;arg&gt;</code> elements to mark the insertion point.</code>
   <h4>env</h4>
   <p>It is possible to specify environment variables to pass to the
   system command via nested <code>&lt;env&gt;</code> elements. See the
  @@ -2194,6 +2199,19 @@
   files below <code>/tmp</code> not ending in <code>.txt</code> and all
   files of the FileSet with <code>id</code> <code>other.files</code> to
   the command line.</p>
  +<blockquote><pre>
  +&lt;execon executable=&quot;somecommand&quot; parallel=&quot;false&quot; &gt;
  +  &lt;arg value=&quot;arg1&quot; /&gt;
  +  &lt;srfile/&gt;
  +  &lt;arg value=&quot;arg2&quot; /&gt;
  +  &lt;fileset dir=&quot;/tmp&quot; /&gt;
  +&lt;/execon&gt;
  +</pre></blockquote>
  +<p>invokes <code>somecommand arg1 SOURCEFILENAME arg2</code> for each
  +file in <code>/tmp</code> replacing SOURCEFILENAME with the absolute
  +filename of each file in turn. If <code>parallel</code> had been set
  +to true, SOURCEFILENAME would be replaced with the absolute filenames
  +of all files separated by spaces.</p>
   <hr>
   <h2><a name="fail">Fail</a></h2>
   <h3>Description</h3>
  @@ -4510,7 +4528,7 @@
   <p>The value part of the property being set is <i>true</i> if the
   timestamp of the target files is more recent than the timestamp of
   every corresponding source file.</p>
  -<p>The default behavior is to use a <a href="merge-mapper">merge
  +<p>The default behavior is to use a <a href="#merge-mapper">merge
   mapper</a> whith the <code>to</code> attribute set to the value of the
   targetfile attribute.</p>
   <p>Normally, this task is used to set properties that are useful to avoid 
target