bodewig 2003/03/19 01:20:53
Modified: docs/manual using.html
Log:
Merge fix for bug 14521 from 1.5 branch
Revision Changes Path
1.28 +8 -8 ant/docs/manual/using.html
Index: using.html
===================================================================
RCS file: /home/cvs/ant/docs/manual/using.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- using.html 4 Oct 2002 11:59:48 -0000 1.27
+++ using.html 19 Mar 2003 09:20:53 -0000 1.28
@@ -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>
@@ -535,7 +535,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>