From 50b49e76bc419533615832fb13011b4eac95257b Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Fri, 21 Aug 2009 12:38:17 +0000
Subject: [PATCH] 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     | 4 +++-
 src/main/org/apache/tools/ant/Target.java | 4 ++++
 2 files changed, 7 insertions(+), 1 deletion(-)

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 {