From ee1f70b4c91b37ebdefec6c48af4fa0e7ec93edc Mon Sep 17 00:00:00 2001
From: Steve Loughran <stevel@apache.org>
Date: Sat, 23 Mar 2002 19:53:05 +0000
Subject: [PATCH] bit more detail on target names

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@271989 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/using.html | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

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:</p>
 <p>If no <code>if</code> and no <code>unless</code> attribute is present,
 the target will always be executed.</p>
 <p>The optional <code>description</code> attribute can be used to provide a one-line description of this target, which is printed by the
-<nobr><code>-projecthelp</code></nobr> command-line option.</p>
+<nobr><code>-projecthelp</code></nobr> command-line option. Targets
+without such a description are deemed internal and will not be listed. 
+</p>
 <p>It is a good practice to place your <a
 href="CoreTasks/tstamp.html">tstamp</a> tasks in a so-called
 <i>initialization</i> target, on which
@@ -137,6 +139,16 @@ have the name &quot;init&quot;.</p>
   </tr>
 </table>
 
+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. 
+
+<p>
+
+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.
 
 <h3><a name="tasks">Tasks</a></h3>
 <p>A task is a piece of code that can be executed.</p>