From 3433f894637a483ae296e25d15112a1297c90011 Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Fri, 7 Dec 2001 11:03:37 +0000
Subject: [PATCH] Advice TaskContainer writers to use Task.perform.

Get rid of javadoc warning in Project.


git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@270087 13f79535-47bb-0310-9956-ffa450edef68
---
 src/main/org/apache/tools/ant/Project.java       | 1 -
 src/main/org/apache/tools/ant/TaskContainer.java | 5 +++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/main/org/apache/tools/ant/Project.java b/src/main/org/apache/tools/ant/Project.java
index 6f1e8b300..469901941 100644
--- a/src/main/org/apache/tools/ant/Project.java
+++ b/src/main/org/apache/tools/ant/Project.java
@@ -339,7 +339,6 @@ public class Project {
      * set a user property, which can not be overwritten by
      * set/unset property calls
      * @see #setProperty(String,String)
-     * @see #unsetProperty(String)
      */
     public void setUserProperty(String name, String value) {
         log("Setting ro project property: " + name + " -> " +
diff --git a/src/main/org/apache/tools/ant/TaskContainer.java b/src/main/org/apache/tools/ant/TaskContainer.java
index 87ca7dadd..46cd33a24 100644
--- a/src/main/org/apache/tools/ant/TaskContainer.java
+++ b/src/main/org/apache/tools/ant/TaskContainer.java
@@ -57,6 +57,11 @@ package org.apache.tools.ant;
 /**
  * Interface for objects which can contain tasks 
  *
+ * <p>It is recommended that implementations call {@link Task#perform
+ * perform} instead of {@link Task#execute execute} for the tasks they
+ * contain, as this method ensures that {@link BuildEvent BuildEvents}
+ * will be generated.</p>
+ *
  * @author <a href="mailto:conor@apache.org">Conor MacNeill</a>
  */
 public interface TaskContainer {