document that targets should have unique locations. PR 47640

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@806528 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/OptionalTasks/script.html

@@ -62,7 +62,9 @@ to an explanation: <a href="http://groups.google.com/groups?hl=en&lr=&ie=UTF-8&o
 Groups@Google: "Rhino, enum.js, JavaAdapter?"</a> by Norris Boyd in the newsgroup
 <i>netscape.public.mozilla.jseng</i>.</p>
 
-
+<p>If you are creating Targets programmatically, make sure you set the
+Location to a useful value.  In particular all targets should have
+different location values.</p>
 
 <h3>Parameters</h3>
 <table border="1" cellpadding="2" cellspacing="0">

src/main/org/apache/tools/ant/Target.java

@@ -29,6 +29,10 @@ import org.apache.tools.ant.property.LocalProperties;
 
 /**
  * Class to implement a target object with required parameters.
+ *
+ * <p>If you are creating Targets programmatically, make sure you set
+ * the Location to a useful value.  In particular all targets should
+ * have different location values.</p>
  */
 public class Target implements TaskContainer {