diff --git a/docs/manual/CoreTasks/property.html b/docs/manual/CoreTasks/property.html index c7b25d2e6..f6ed34149 100644 --- a/docs/manual/CoreTasks/property.html +++ b/docs/manual/CoreTasks/property.html @@ -154,22 +154,28 @@ SYSTEM). No +

Parameters specified as nested elements

classpath

Property's classpath attribute is a PATH like structure and can also be set via a nested classpath element.

+

Examples

  <property name="foo.dist" value="dist"/>

sets the property foo.dist to the value "dist".

+
  <property file="foo.properties"/>

reads a set of properties from a file called "foo.properties".

+
  <property url="http://www.mysite.com/bla/props/foo.properties"/>

reads a set of properties from the address "http://www.mysite.com/bla/props/foo.properties".

+
  <property resource="foo.properties"/>

reads a set of properties from a resource called "foo.properties".

Note that you can reference a global properties file for all of your Ant builds using the following:

+
  <property file="${user.home}/.ant-global.properties"/>

since the "user.home" property is defined by the Java virtual machine to be your home directory. Where the "user.home" property resolves to in @@ -189,6 +195,18 @@ Note that this only works on select operating systems. Two of the values are shown being echoed.

+
+  <property environment="env"/>
+  <property file="${user.name}.properties"/>
+  <property file="${env.STAGE}.properties"/>
+  <property file="build.properties"/>
+
+

This buildfile uses the properties defined in build.properties. Regarding to the +environment variable STAGE some or all values could be overwritten, e.g. having +STAGE=test and a test.properties you have special values for that (like another +name for the test server). Finally all these values could be overwritten by personal settings with +a file per user.

+

Property Files

As stated, this task will load in a properties file stored in the file