ant-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r749409 - /ant/core/branches/ANT_17_BRANCH/docs/manual/CoreTasks/property.html
Date Mon, 02 Mar 2009 18:48:05 GMT
Author: peterreilly
Date: Mon Mar  2 18:48:04 2009
New Revision: 749409

42946: need to add doc for xml format in 1.7.*


Modified: ant/core/branches/ANT_17_BRANCH/docs/manual/CoreTasks/property.html
--- ant/core/branches/ANT_17_BRANCH/docs/manual/CoreTasks/property.html (original)
+++ ant/core/branches/ANT_17_BRANCH/docs/manual/CoreTasks/property.html Mon Mar  2 18:48:04
@@ -57,6 +57,10 @@
 This also holds for properties loaded from a property file.</p>
 <p>A list of predefined properties can be found <a
+<p>Since Ant 1.7.1 it is possible to load properties defined in xml
+according to <a href="">Suns DTD</a>,
+if Java5+ is present. For this the name of the file, resource or url has 
+to end with <tt>.xml</tt>.</p>
 <h4>OpenVMS Users</h4>
 <p>With the <code>environment</code> attribute this task will load all
@@ -150,22 +154,28 @@
     <td align="center" valign="top">No</td>
 <h3>Parameters specified as nested elements</h3>
 <p><code>Property</code>'s <i>classpath</i> attribute is a
 href="../using.html#path">PATH like structure</a> and can also be set via a nested
 <i>classpath</i> element.</p>
 <pre>  &lt;property name=&quot;foo.dist&quot; value=&quot;dist&quot;/&gt;</pre>
 <p>sets the property <code>foo.dist</code> to the value &quot;dist&quot;.</p>
 <pre>  &lt;property file=&quot;;/&gt;</pre>
 <p>reads a set of properties from a file called &quot;;.</p>
 <pre>  &lt;property url=&quot;;/&gt;</pre>
 <p>reads a set of properties from the address &quot;;.</p>
 <pre>  &lt;property resource=&quot;;/&gt;</pre>
 <p>reads a set of properties from a resource called &quot;;.</p>
 <p>Note that you can reference a global properties file for all of your Ant
 builds using the following:</p>
 <pre>  &lt;property file=&quot;${user.home}/;/&gt;</pre>
 <p>since the &quot;user.home&quot; property is defined by the Java virtual
 to be your home directory.  Where the &quot;user.home&quot; property resolves to
@@ -185,6 +195,18 @@
 Two of the values are shown being echoed.
+  &lt;property environment=&quot;env&quot;/&gt;
+  &lt;property file=&quot;${}.properties&quot;/&gt;
+  &lt;property file=&quot;${env.STAGE}.properties&quot;/&gt;
+  &lt;property file=&quot;;/&gt;
+<p>This buildfile uses the properties defined in <tt></tt>.
Regarding to the
+environment variable <tt>STAGE</tt> some or all values could be overwritten,
e.g. having
+<tt>STAGE=test</tt> and a <tt></tt> you have special
values for that (like another
+name for the test server). Finally all these values could be overwritten by personal settings
+a file per user.</p>
 <h3>Property Files</h3>
 As stated, this task will load in a properties file stored in the file

View raw message