<control : apply>

Description

Executes a given command, supplying a set of files as arguments.

Parameters

Attribute Description Type Required?
resultproperty String ?
skipemptyfilesets Set whether empty filesets will be skipped. If true and no source files have been found or are newer than their corresponding target files, the command will not be run. boolean ?
force Set whether to bypass timestamp comparisons for target files. boolean ?
failifexecutionfails boolean ?
command Commandline ?
type Set whether the command works only on files, directories or both. String ["file", "dir", "both"] ?
maxparallel Limit the command line length by passing at maximum this many sourcefiles at once to the command.

Set to <= 0 for unlimited - this is the default.

int ?
executable String ?
errorproperty String ?
os String ?
output File ?
timeout Integer ?
dest Specify the directory where target files are to be placed. File ?
spawn boolean ?
input File ?
inputstring String ?
addsourcefile Set whether to send the source file name on the command line.

Defaults to true.

boolean ?
verbose Set whether to operate in verbose mode. If true, a verbose summary will be printed after execution. boolean ?
searchpath boolean ?
logerror boolean ?
dir File ?
forwardslash Set whether the source and target file names on Windows and OS/2 must use the forward slash as file separator. boolean ?
error File ?
outputproperty String ?
append boolean ?
resolveexecutable boolean ?
failonerror boolean ?
ignoremissing Set whether to ignore nonexistent files from filelists. boolean ?
vmlauncher boolean ?
newenvironment boolean ?
relative Set whether the filenames should be passed on the command line as absolute or relative pathnames. Paths are relative to the base directory of the corresponding fileset for source files or the dest attribute for target files. boolean ?
parallel Set whether to execute in parallel mode. If true, run the command only once, appending all files as arguments. If false, command will be executed once for every file. Defaults to false. boolean ?

Parameters accepted as nested elements

<mapper> ...

Element to define a FileNameMapper.
Attribute Description Type Required
classpath Set the classpath to load the FileNameMapper through (attribute). Path ?
classpathref Set the classpath to load the FileNameMapper through via reference (attribute). Reference ?
refid Make this Mapper instance a reference to another Mapper.

You must not set any other attribute if you make it a reference.

Reference ?
type Set the type of FileNameMapper to use. String ["identity", "flatten", "glob", "merge", "regexp", "package", "unpackage"] ?
classname Set the class name of the FileNameMapper to use. String ?
from Set the argument to FileNameMapper.setFrom String ?
to Set the argument to FileNameMapper.setTo String ?

<srcfile>

Class to keep track of the position of an Argument.

This class is there to support the srcfile and targetfile elements of <execon> and <transform> - don't know whether there might be additional use cases.

--SB
Attribute Description Type Required

<targetfile>

Class to keep track of the position of an Argument.

This class is there to support the srcfile and targetfile elements of <execon> and <transform> - don't know whether there might be additional use cases.

--SB
Attribute Description Type Required

<redirector> ...

Element representation of a Redirector.
Attribute Description Type Required
refid Makes this instance in effect a reference to another instance.

You must not set another attribute or nest elements inside this element if you make it a reference.

Reference ?
inputencoding Set the input encoding. String ?
append Whether output should be appended to or overwrite an existing file. Defaults to false. boolean ?
createemptyfiles Whether output and error files should be created even when empty. Defaults to true. boolean ?
output File the output of the process is redirected to. If error is not redirected, it too will appear in the output File ?
outputproperty Property name whose value should be set to the output of the process. String ?
outputencoding Set the output encoding. String ?
errorproperty Property name whose value should be set to the error of the process. String ?
error Set the file to which standard error is to be redirected. File ?
inputstring Set the string to use as input String ?
alwayslog If true, (error and non-error) output will be "teed", redirected as specified while being sent to Ant's logging mechanism as if no redirection had taken place. Defaults to false. boolean ?
input Set the input to use for the task File ?
errorencoding Set the error encoding. String ?
logerror Controls whether error output of exec is logged. This is only useful when output is being redirected and error output is desired in the Ant log boolean ?

<filelist> ...

FileList represents an explicitly named list of files. FileLists are useful when you want to capture a list of files regardless of whether they currently exist. By contrast, FileSet operates as a filter, only returning the name of a matched file if it currently exists in the file system.
Attribute Description Type Required
dir Set the dir attribute. File ?
refid Makes this instance in effect a reference to another FileList instance.

You must not set another attribute or nest elements inside this element if you make it a reference.

Reference ?
files Set the filenames attribute. String ?

<env>

representation of a single env value
Attribute Description Type Required
key set the key String ?
file get the absolute path of a file and assign it to the value File ?
value set the value String ?
path stringify path and assign to the value. The value will contain all path elements separated by the appropriate separator Path ?

<fileset> ...

Moved out of MatchingTask to make it a standalone object that could be referenced (by scripts for example).
Attribute Description Type Required
refid Reference ?
file File ?
dir File ?
defaultexcludes boolean ?
followsymlinks boolean ?
casesensitive boolean ?
excludes String ?
includesfile File ?
excludesfile File ?
includes String ?

<dirset> ...

Subclass as hint for supporting tasks that the included directories instead of files should be used.
Attribute Description Type Required
refid Reference ?
file File ?
dir File ?
defaultexcludes boolean ?
followsymlinks boolean ?
casesensitive boolean ?
excludes String ?
includesfile File ?
excludesfile File ?
includes String ?

<arg>

Used for nested xml command line definitions.
Attribute Description Type Required
line Line to split into several commandline arguments. String ?
file Sets a single commandline argument to the absolute filename of the given file. File ?
pathref Sets a single commandline argument from a reference to a path - ensures the right separator for the local platform is used. Reference ?
value Sets a single commandline argument. String ?
path Sets a single commandline argument and treats it like a PATH - ensures the right separator for the local platform is used. Path ?