stevel 2002/06/19 20:45:45
Modified: docs/manual/CoreTasks Tag: ANT_15_BRANCH property.html
Log:
clarified the immutability statement
Revision Changes Path
No revision
No revision
1.10.2.2 +8 -11 jakarta-ant/docs/manual/CoreTasks/property.html
Index: property.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/CoreTasks/property.html,v
retrieving revision 1.10.2.1
retrieving revision 1.10.2.2
diff -u -r1.10.2.1 -r1.10.2.2
--- property.html 3 May 2002 09:40:28 -0000 1.10.2.1
+++ property.html 20 Jun 2002 03:45:45 -0000 1.10.2.2
@@ -11,11 +11,8 @@
<h3>Description</h3>
<p>Sets a property (by name and value), or set of properties (from file or
resource) in the project. Properties are case sensitive.</p>
-<p>When a property was set by the user, or was a property in a parent project
-(that started this project with the <a href="ant.html">ant task</a>), then
this
-property cannot be set, and will be ignored. This means that properties set
-outside the current project always override the properties of the current
-project.</p>
+ Properties are immutable: whoever sets a property first freezes it for the
+ of the build; they are most definately not variable.
<p>There are five ways to set properties:</p>
<ul>
<li>By supplying both the <i>name</i> and <i>value</i> attribute.</li>
@@ -30,7 +27,7 @@
Properties will be defined for every environment variable by
prefixing the supplied name and a period to the name of the
variable.</li>
</ul>
-<p>Although combinations of the three ways are possible, only one should be
used
+<p>Although combinations of these ways are possible, only one should be used
at a time. Problems might occur with the order in which properties are set,
for
instance.</p>
<p>The value part of the properties being set, might contain references to
other
@@ -85,10 +82,10 @@
<td valign="top">the prefix to use when retrieving environment
variables. 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 that 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". This functionality is currently only
implemented
+ "myenv.TERM". Note that 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". This functionality is currently only implemented
on select platforms. Feel free to send patches to increase the number of
platforms
this functionality is supported on ;).<br>
Note also that properties are case sensitive, even if the
@@ -104,7 +101,7 @@
<tr>
<td valign="top">classpathref</td>
<td valign="top">the classpath to use when looking up a resource,
- given as <a href="../using.html#references">reference</a> to a PATH
defined
+ given as <a href="../using.html#references">reference</a> to a
<path> defined
elsewhere..</td>
<td align="center" valign="top">No</td>
</tr>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
