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>