Sets a property (by name and value), or set of properties (from file or +
Sets a property +(by name and value), or set of properties (from file or resource) in the project. Properties are case sensitive.
Properties are immutable: whoever sets a property first freezes it for the rest of the build; they are most definitely not variable. diff --git a/docs/manual/using.html b/docs/manual/using.html index 5d8b8c85a..4b50f2241 100644 --- a/docs/manual/using.html +++ b/docs/manual/using.html @@ -245,6 +245,19 @@ if there is a "builddir" property with the value "build", then this could be used in an attribute like this:${builddir}/classes.
This is resolved at run-time as build/classes.
+In the event you should need to include this construct literally +(i.e. without property substitutions), simply "escape" the '$' character +by doubling it. To continue the previous example: +
<echo>$${builddir}=${builddir}</echo>
+will echo this message:
+ ${builddir}=build/classes
+In order to maintain backward compatibility with older Ant releases, +a single '$' character encountered apart from a property-like construct +(including a matched pair of french braces) will be interpreted literally; +that is, as '$'. The "correct" way to specify this literal character, +however, is by using the escaping mechanism unconditionally, so that "$$" +is obtained by specifying "$$$$". Mixing the two approaches yields +unpredictable results, as "$$$" results in "$$".
Ant provides access to all system properties as if they had been