bodewig 2003/03/19 01:19:51
Modified: docs/manual Tag: ANT_15_BRANCH using.html
Log:
Add an extra note about properties values being irrelevant for if/unless.
PR: 14521
Revision Changes Path
No revision
No revision
1.21.2.4 +8 -8 ant/docs/manual/using.html
Index: using.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/using.html,v
retrieving revision 1.21.2.3
retrieving revision 1.21.2.4
diff -u -r1.21.2.3 -r1.21.2.4
--- using.html 9 Aug 2002 08:39:47 -0000 1.21.2.3
+++ using.html 19 Mar 2003 09:19:50 -0000 1.21.2.4
@@ -85,7 +85,9 @@
(java version, OS, command-line property defines, etc.). To make a target
<i>sense</i> this property, you should add the <code>if</code> (or
<code>unless</code>) attribute with the name of the property that the target
-should react to. For example:</p>
+should react to. <strong>Note:</strong> Ant will only check whether
+the property has been set, the value doesn't matter. A property set
+to the empty string is still an existing property. For example:</p>
<blockquote>
<pre><target name="build-module-A"
if="module-A-present"/></pre>
<pre><target name="build-own-fake-module-A"
unless="module-A-present"/></pre>
@@ -147,18 +149,16 @@
</table>
</p>
-A target name can be any alphanumeric string valid in the encoding of the XML
+<p>A target name can be any alphanumeric string valid in the encoding of the
XML
file. The empty string "" is in this set, as is
comma "," and space " ".
Please avoid using these, as they will not be supported in future Ant
versions
because of all the confusion they cause. IDE support of unusual target names,
-or any target name containing spaces, varies with the IDE.
+or any target name containing spaces, varies with the IDE.</p>
-<p>
-
-Targets beginning with a hyphen such as <code>"-restart"</code>
+<p>Targets beginning with a hyphen such as <code>"-restart"</code>
are valid, and can be used
-to name targets that should not be called directly from the command line.
+to name targets that should not be called directly from the command line.</p>
<h3><a name="tasks">Tasks</a></h3>
<p>A task is a piece of code that can be executed.</p>
@@ -529,7 +529,7 @@
structures as well.</p>
<hr>
-<p align="center">Copyright © 2000-2002 Apache Software Foundation. All
rights
+<p align="center">Copyright © 2000-2003 Apache Software Foundation. All
rights
Reserved.</p>
</body>
