You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by bo...@apache.org on 2003/09/19 10:44:23 UTC

cvs commit: ant/docs/manual/CoreTasks apply.html exec.html

bodewig     2003/09/19 01:44:23

  Modified:    docs/manual/CoreTasks apply.html exec.html
  Log:
  Update and sync <apply> and <exec> docs
  
  Revision  Changes    Path
  1.23      +64 -4     ant/docs/manual/CoreTasks/apply.html
  
  Index: apply.html
  ===================================================================
  RCS file: /home/cvs/ant/docs/manual/CoreTasks/apply.html,v
  retrieving revision 1.22
  retrieving revision 1.23
  diff -u -r1.22 -r1.23
  --- apply.html	24 Jun 2003 09:16:10 -0000	1.22
  +++ apply.html	19 Sep 2003 08:44:22 -0000	1.23
  @@ -47,6 +47,17 @@
       <td align="center" valign="top">Yes, if you specify a nested mapper</td>
     </tr>
     <tr>
  +    <td valign="top">spawn</td>
  +    <td valign="top">whether or not you want the commands to be spawned<br/>
  +    Default is false.<br>
  +    If you spawn a command, its output will not be logged by ant.<br/>
  +    The input, output, error, and result property settings are not active when spawning a process.<br>
  +    <em>since Ant 1.6</em>
  +    </td>
  +    <td align="center" valign="top">No</td>
  +  </tr>
  +
  +  <tr>
       <td valign="top">dir</td>
       <td valign="top">the directory in which the command should be executed.</td>
       <td align="center" valign="top">No</td>
  @@ -75,8 +86,25 @@
     </tr>
     <tr>
       <td valign="top">output</td>
  -    <td valign="top">the file to which the output of the command should be
  -      redirected.</td>
  +    <td valign="top">the file to which the output of the command
  +    should be redirected.  If the error stream is not also redirected
  +    to a file or property, it will appear in this output.</td>
  +    <td align="center" valign="top">No</td>
  +  </tr>
  +  <tr>
  +    <td valign="top">error</td>
  +    <td valign="top">The file to which the standard error of the
  +    command should be redirected.  <em>since Ant 1.6</em></td>
  +    <td align="center" valign="top">No</td>
  +  </tr>
  +  <tr>
  +    <td valign="top">logError</td>
  +    <td valign="top">This attribute is used when you wish to see error
  +    output in Ant's log and you are redirecting output to a
  +    file/property. The error output will not be included in the output
  +    file/property. If you redirect error with the &quot;error&quot; or
  +    &quot;errorProperty&quot; attributes, this will have no effect.
  +    <em>since Ant 1.6</em></td>
       <td align="center" valign="top">No</td>
     </tr>
     <tr>
  @@ -88,8 +116,30 @@
     </tr>
     <tr>
       <td valign="top">outputproperty</td>
  -    <td valign="top">the name of a property in which the output of the 
  -      command should be stored.</td>
  +    <td valign="top">the name of a property in which the output of the
  +    command should be stored.  Unless the error stream is redirected
  +    to a separate file or stream, this property will include the error
  +    output.</td>
  +    <td align="center" valign="top">No</td>
  +  </tr>
  +  <tr>
  +    <td valign="top">errorproperty</td>
  +    <td valign="top">The name of a property in which the standard error of the 
  +      command should be stored.  <em>since Ant 1.6</em></td>
  +    <td align="center" valign="top">No</td>
  +  </tr>
  +  <tr>
  +    <td valign="top">input</td>
  +    <td valign="top">A file from which the executed command's standard
  +    input is taken. This attribute is mutually exclusive with the
  +    inputstring attribute.  <em>since Ant 1.6</em></td>
  +    <td align="center" valign="top">No</td>
  +  </tr>
  +  <tr>
  +    <td valign="top">inputstring</td>
  +    <td valign="top">A string which serves as the input stream for the
  +    executed command. This attribute is mutually exclusive with the
  +    input attribute.  <em>since Ant 1.6</em></td>
       <td align="center" valign="top">No</td>
     </tr>
     <tr>
  @@ -164,6 +214,16 @@
           false as well.</td>
       <td align="center" valign="top">No, default is <i>true</i></td>
     </tr>
  +  <tr>
  +    <td valign="top">resolveExecutable</td>
  +    <td valign="top">When this attribute is true, the name of the
  +    executable if resolved firstly against the project basedir and if
  +    that does not exist, against the execution directory if
  +    specified. On Unix systems, if you only want to allow execution of
  +    commands in the user's path, set this to false.  <em>since Ant
  +    1.6</em></td>
  +    <td align="center" valign="top">No, default is <i>false</i></td>
  +  </tr>                     
     <tr>
       <td valign="top">maxparallel</td>
       <td valign="top">Limit the amount of parallelism by passing at
  
  
  
  1.34      +10 -8     ant/docs/manual/CoreTasks/exec.html
  
  Index: exec.html
  ===================================================================
  RCS file: /home/cvs/ant/docs/manual/CoreTasks/exec.html,v
  retrieving revision 1.33
  retrieving revision 1.34
  diff -u -r1.33 -r1.34
  --- exec.html	6 Sep 2003 15:48:01 -0000	1.33
  +++ exec.html	19 Sep 2003 08:44:22 -0000	1.34
  @@ -73,7 +73,8 @@
       <td valign="top">whether or not you want the command to be spawned<br/>
       Default is false.<br>
       If you spawn a command, its output will not be logged by ant.<br/>
  -    The input, output, error, and result property settings are not active when spawning a process.
  +    The input, output, error, and result property settings are not active when spawning a process.<br>
  +    <em>since Ant 1.6</em>
       </td>
       <td align="center" valign="top">No</td>
     </tr>
  @@ -85,8 +86,8 @@
     </tr>
     <tr>
       <td valign="top">error</td>
  -    <td valign="top">The file to which the standard error of the command should be
  -      redirected. </td>
  +    <td valign="top">The file to which the standard error of the
  +    command should be redirected.  <em>since Ant 1.6</em></td>
       <td align="center" valign="top">No</td>
     </tr>
     <tr>
  @@ -95,7 +96,7 @@
                        log and you are redirecting output to a file/property. The error 
                        output will not be included in the output file/property. If you 
                        redirect error with the &quot;error&quot; or &quot;errorProperty&quot;
  -                     attributes, this will have no effect.</td>
  +                     attributes, this will have no effect.  <em>since Ant 1.6</em></td>
       <td align="center" valign="top">No</td>
     </tr>
     <tr>
  @@ -114,21 +115,21 @@
     <tr>
       <td valign="top">errorproperty</td>
       <td valign="top">The name of a property in which the standard error of the 
  -      command should be stored.</td>
  +      command should be stored.  <em>since Ant 1.6</em></td>
       <td align="center" valign="top">No</td>
     </tr>
     <tr>
       <td valign="top">input</td>
       <td valign="top">A file from which the executed command's standard input
                        is taken. This attribute is mutually exclusive with the
  -                     inputstring attribute</td>
  +                     inputstring attribute.  <em>since Ant 1.6</em></td>
       <td align="center" valign="top">No</td>
     </tr>
     <tr>
       <td valign="top">inputstring</td>
       <td valign="top">A string which serves as the input stream for the 
                        executed command. This attribute is mutually exclusive with the
  -                     input attribute.</td>
  +                     input attribute.  <em>since Ant 1.6</em></td>
       <td align="center" valign="top">No</td>
     </tr>
     <tr>
  @@ -181,7 +182,8 @@
                        if that does not exist, against the execution
                        directory if specified. On Unix systems, if you only 
                        want to allow execution of commands in the user's path, 
  -                     set this to false.</td>
  +                     set this to false.  <em>since Ant 1.6</em></td>
  +    <td align="center" valign="top">No, default is <i>false</i></td>
     </tr>                     
   </table>
   <h3>Examples</h3>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org