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

@@ -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 + " -> " +

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 {