Attribute |
Description |
Type |
Required? |
output |
Set the filename to write the output to. This is relative to the value
of the dir attribute if it has been set or to the base directory of the
current project otherwise.
|
String
|
?
|
inheritall |
If true, pass all properties to the new Ant project.
Defaults to true.
|
boolean
|
?
|
dir |
The directory to use as a base directory for the new Ant project.
Defaults to the current project's basedir, unless inheritall
has been set to false, in which case it doesn't have a default
value. This will override the basedir setting of the called project.
|
File
|
?
|
inheritrefs |
If true, pass all references to the new Ant project.
Defaults to false.
|
boolean
|
?
|
target |
The target of the new Ant project to execute.
Defaults to the new project's default target.
|
String
|
?
|
antfile |
The build file to use. Defaults to "build.xml". This file is expected
to be a filename relative to the dir attribute given.
|
String
|
?
|
<reference>
Helper class that implements the nested <reference>
element of <ant> and <antcall>.
Attribute |
Description |
Type |
Required |
torefid |
Set the id that this reference to be stored under in the
new project.
|
String
|
?
|
refid |
|
String
|
?
|
A set of properties.
Attribute |
Description |
Type |
Required |
refid |
Sets the value of the refid attribute.
|
Reference
|
?
|
dynamic |
Set whether to reevaluate the set everytime the set is used.
Default is true.
|
boolean
|
?
|
negate |
Set whether to negate results.
If "true", all properties not selected by nested elements will be returned.
Default is "false".
|
boolean
|
?
|
Sets a property by name, or set of properties (from file or
resource) in the project.
Properties are immutable: whoever sets a property first freezes it for the
rest of the build; they are most definitely not variable.
There are five ways to set properties:
- By supplying both the name and value attribute.
- By supplying both the name and refid attribute.
- By setting the file attribute with the filename of the property
file to load. This property file has the format as defined by the file used
in the class java.util.Properties.
- By setting the resource attribute with the resource name of the
property file to load. This property file has the format as defined by the
file used in the class java.util.Properties.
- By setting the environment attribute with a prefix to use.
Properties will be defined for every environment variable by
prefixing the supplied name and a period to the name of the variable.
Although combinations of these ways are possible, only one should be used
at a time. Problems might occur with the order in which properties are set, for
instance.
The value part of the properties being set, might contain references to other
properties. These references are resolved at the time these properties are set.
This also holds for properties loaded from a property file.
Properties are case sensitive.
Attribute |
Description |
Type |
Required |
refid |
Sets a reference to an Ant datatype
declared elsewhere.
Only yields reasonable results for references
PATH like structures or properties.
|
Reference
|
?
|
url |
The url from which to load properties.
|
URL
|
?
|
name |
The name of the property to set.
|
String
|
?
|
classpath |
The classpath to use when looking up a resource.
|
Path
|
?
|
userproperty |
|
boolean
|
?
|
file |
Filename of a property file to load.
|
File
|
?
|
resource |
The resource name of a property file to load
|
String
|
?
|
environment |
Prefix to use when retrieving environment variables.
Thus if you specify environment="myenv"
you will be able to access OS-specific
environment variables via property names "myenv.PATH" or
"myenv.TERM".
Note that if you supply a property name with a final
"." it will not be doubled. ie environment="myenv." will still
allow access of environment variables through "myenv.PATH" and
"myenv.TERM". This functionality is currently only implemented
on select platforms. Feel free to send patches to increase the number of platforms
this functionality is supported on ;).
Note also that properties are case sensitive, even if the
environment variables on your operating system are not, e.g. it
will be ${env.Path} not ${env.PATH} on Windows 2000.
|
String
|
?
|
prefix |
Prefix to apply to properties loaded using file
or resource .
A "." is appended to the prefix if not specified.
|
String
|
?
|
classpathref |
the classpath to use when looking up a resource,
given as reference to a <path> defined elsewhere
|
Reference
|
?
|
value |
The value of the property.
|
String
|
?
|
<target>
Helper class that implements the nested <target>
element of <ant> and <antcall>.
Attribute |
Description |
Type |
Required |
name |
Set the name of this TargetElement.
|
String
|
?
|