diff --git a/docs/index.html b/docs/index.html index 7bde0497f..b6ef8eba6 100644 --- a/docs/index.html +++ b/docs/index.html @@ -753,6 +753,7 @@ same patterns as the example before.

  • Deltree
  • Echo
  • Exec
  • +
  • ExecOn
  • Filter
  • FixCRLF
  • GenKey
  • @@ -1453,6 +1454,99 @@ system command via nested <env> elements.

    adds ${basedir}/bin to the PATH of the system command.


    +

    ExecOn

    +

    Description

    +

    Executes a system command. When the os attribute is specified, then +the command is only executed when Ant is run on one of the specified operating +systems.

    +

    The files of a number of FileSets are passed +as arguments to the system command. At least one nested +<fileset> or <filesetref> is +required.

    +

    Parameters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    AttributeDescriptionRequired
    executablethe command to execute without any command line + arguments.Yes
    dirthe directory in which the command should be executed.No
    oslist of Operating Systems on which the command may be + executed.No
    outputthe file to which the output of the command should be + redirected.No
    timeoutStop the command if it doesn't finish within the + specified time (given in milliseconds).No
    failonerrorStop the buildprocess if the command exits with a + returncode other than 0.No
    parallelRun the command only once, appending all files as + arguments. Defaults to true. If false, command will be executed + once for every file.No
    +

    Parameters specified as nested elements

    +

    fileset and filesetref

    +

    You can use any number of nested <fileset> +elements to define the files for this task and refer to +<fileset>s defined elsewhere via +<filesetref> elements.

    +

    arg

    +

    Command line arguments should be specified as nested +<arg> elements. See Command line arguments.

    +

    env

    +

    It is possible to specify environment variables to pass to the +system command via nested <env> elements. See the +description in the section about exec

    +

    Please note that the environment of the current Ant process is +not passed to the system command if you specify variables using +<env>.

    +

    Examples

    +
    +<execon executable="ls" >
    +  <arg value="-l" />
    +  <fileset dir="/tmp">
    +    <patternset>
    +      <exclude name="**/*.txt" />
    +    </patternset>
    +  </fileset>
    +  <filesetref refid="other.files" />
    +</execon>
    +
    +

    invokes ls -l, adding the absolute filenames of all +files below /tmp not ending in .txt and all +files of the FileSet with ID other.files to +the command line.

    +

    Filter

    Description

    Sets a token filter for this project. Token filters are used by all tasks @@ -2008,7 +2102,7 @@ the one that is currently running Ant.

    jvmargs the arguments to pass to the forked VM (ignored if fork is disabled). deprecated, use nested - <arg> elements instead. + <jvmarg> elements instead. No @@ -3399,6 +3493,7 @@ carried from zipfile.

    Untar

    Description

    Untars a tarfile.

    +

    File permissions will not be restored on extracted files.

    For JDK 1.1 "last modified time" field is set to current time instead of being carried from tarfile.

    Parameters

    @@ -3652,7 +3747,7 @@ output.

    FTP

    Description:

    Copies files from the local system to a remote ftp server.

    -

    The fileset syntax must be used for specifying the local +

    The fileset syntax must be used for specifying the local files to copy. All filesets will be copied into the single remote directory specified by remotedir.

    The ftp task makes no attempt to determine what file system syntax is @@ -4148,7 +4243,7 @@ elements.

    Script

    Description:

    Execute a script in a - BSF supported language. + BSF supported language.

    All items (tasks, targets, etc) of the running project are accessible from the script.

    Parameters: