svn commit: r712948 - /ant/core/trunk/docs/manual/CoreTasks/property.html

[jhm]

Author: jhm
Date: Mon Nov 10 21:54:58 2008
New Revision: 712948

URL: http://svn.apache.org/viewvc?rev=712948&view=rev
Log:
additional example

Modified:
    ant/core/trunk/docs/manual/CoreTasks/property.html

Modified: ant/core/trunk/docs/manual/CoreTasks/property.html
URL: 
http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/CoreTasks/property.html?rev=712948&r1=712947&r2=712948&view=diff
==============================================================================
--- ant/core/trunk/docs/manual/CoreTasks/property.html (original)
+++ ant/core/trunk/docs/manual/CoreTasks/property.html Mon Nov 10 21:54:58 2008
@@ -154,22 +154,28 @@
     <td align="center" valign="top">No</td>
   </tr>
 </table>
+
 <h3>Parameters specified as nested elements</h3>
 <h4>classpath</h4>
 <p><code>Property</code>'s <i>classpath</i> attribute is a <a
 href="../using.html#path">PATH like structure</a> and can also be set via a 
nested
 <i>classpath</i> element.</p>
+
 <h3>Examples</h3>
 <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;foo.properties&quot;/&gt;</pre>
 <p>reads a set of properties from a file called &quot;foo.properties&quot;.</p>
+
 <pre>  &lt;property 
url=&quot;http://www.mysite.com/bla/props/foo.properties&quot;/&gt;</pre>
 <p>reads a set of properties from the address 
&quot;http://www.mysite.com/bla/props/foo.properties&quot;.</p>
+
 <pre>  &lt;property resource=&quot;foo.properties&quot;/&gt;</pre>
 <p>reads a set of properties from a resource called 
&quot;foo.properties&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}/.ant-global.properties&quot;/&gt;</pre>
 <p>since the &quot;user.home&quot; property is defined by the Java virtual 
machine
 to be your home directory.  Where the &quot;user.home&quot; property resolves 
to in
@@ -189,6 +195,18 @@
 Two of the values are shown being echoed.
 </p>
 
+<pre>
+  &lt;property environment=&quot;env&quot;/&gt;
+  &lt;property file=&quot;${user.name}.properties&quot;/&gt;
+  &lt;property file=&quot;${env.STAGE}.properties&quot;/&gt;
+  &lt;property file=&quot;build.properties&quot;/&gt;
+</pre>
+<p>This buildfile uses the properties defined in <tt>build.properties</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>test.properties</tt> 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.</p>
+
 <h3>Property Files</h3>
 
 As stated, this task will load in a properties file stored in the file