diff --git a/docs/manual/using.html b/docs/manual/using.html index b6d9f58bf..dc941c5f3 100644 --- a/docs/manual/using.html +++ b/docs/manual/using.html @@ -93,7 +93,9 @@ should react to. For example:

If no if and no unless attribute is present, the target will always be executed.

The optional description attribute can be used to provide a one-line description of this target, which is printed by the --projecthelp command-line option.

+-projecthelp command-line option. Targets +without such a description are deemed internal and will not be listed. +

It is a good practice to place your tstamp tasks in a so-called initialization target, on which @@ -137,6 +139,16 @@ have the name "init".

+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. IDEs support of unusual target names +-or any target name containing spaces, varies with the IDE. + +

+ +Targets beginning with a hyphen such as "-restart" are valid, and can be used +to name targets which must not be called directly from the command like.

Tasks

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