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 {