diff --git a/docs/manual/OptionalTasks/script.html b/docs/manual/OptionalTasks/script.html
index 8d55f9b8d..559186d4c 100644
--- a/docs/manual/OptionalTasks/script.html
+++ b/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">
diff --git a/src/main/org/apache/tools/ant/Target.java b/src/main/org/apache/tools/ant/Target.java
index e9e168ad6..f92369e35 100644
--- a/src/main/org/apache/tools/ant/Target.java
+++ b/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 {