diff --git a/docs/manual/using.html b/docs/manual/using.html index d4feb7635..225fc32ab 100644 --- a/docs/manual/using.html +++ b/docs/manual/using.html @@ -85,7 +85,9 @@ control on the building process depending on the state of the system (java version, OS, command-line property defines, etc.). To make a target sense this property, you should add the if (or unless) attribute with the name of the property that the target -should react to. For example:

+should react to. Note: 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:

<target name="build-module-A" if="module-A-present"/>
<target name="build-own-fake-module-A" unless="module-A-present"/>
@@ -147,18 +149,16 @@ have the name "init".

-A target name can be any alphanumeric string valid in the encoding of the XML +

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.

-

- -Targets beginning with a hyphen such as "-restart" +

Targets beginning with a hyphen such as "-restart" 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.

Tasks

A task is a piece of code that can be executed.

@@ -535,7 +535,7 @@ href="CoreTypes/patternset.html">PatternSets, Copyright © 2000-2002 Apache Software Foundation. All rights +

Copyright © 2000-2003 Apache Software Foundation. All rights Reserved.