| Sets a property by name, or set of properties (from file or resource) in the project. This is
modeled after ant properties
Properties are immutable: once a property is set it cannot be changed. They are most definately
not variable.
There are five ways to set properties:
- By supplying both the name and value attributes.
- 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 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.
Combinations of the above are considered an error.
The value part of the properties being set, might contain references to other properties. These
references are resolved when the properties are set.
This also holds for properties loaded from a property file.
Properties are case sensitive.
When specifying the environment attribute, it's value is used as a prefix to use when retrieving
environment variables. This functionality is currently only implemented on select platforms.
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 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.
Note that when specifying either the prefix or environment
attributes, 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".
| 