dIon's cleanup and doc patches. I put this on the HEAD branch so as to not touch 1.5 branch right before the release.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@273080 13f79535-47bb-0310-9956-ffa450edef68

src/main/org/apache/tools/ant/AntClassLoader.java

@@ -54,24 +54,25 @@
 
 package org.apache.tools.ant;
 
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStream;
 import java.lang.reflect.Constructor;
-import java.lang.reflect.Method;
 import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.net.MalformedURLException;
+import java.net.URL;
 import java.util.Enumeration;
-import java.util.Vector;
 import java.util.Hashtable;
-import java.util.zip.ZipFile;
+import java.util.Vector;
 import java.util.zip.ZipEntry;
-import java.io.File;
-import java.io.InputStream;
-import java.io.FileInputStream;
-import java.io.IOException;
-import java.io.ByteArrayOutputStream;
-import java.net.URL;
-import java.net.MalformedURLException;
+import java.util.zip.ZipFile;
+
 import org.apache.tools.ant.types.Path;
-import org.apache.tools.ant.util.LoaderUtils;
 import org.apache.tools.ant.util.JavaEnvUtils;
+import org.apache.tools.ant.util.LoaderUtils;
 
 /**
  * Used to load classes within ant with a different claspath from

src/main/org/apache/tools/ant/DynamicConfigurator.java

@@ -61,8 +61,23 @@ package org.apache.tools.ant;
  * @since Ant 1.5
  */
 public interface DynamicConfigurator {
+    
+    /**
+     * Set a named attribute to the given value
+     * 
+     * @param name the name of the attribute
+     * @param value the new value of the attribute
+     * @throws BuildException when any error occurs
+     */    
     public void setDynamicAttribute(String name, String value)
             throws BuildException;
 
+    /**
+     * Create an element with the given name
+     *
+     * @param name the element nbame
+     * @throws BuildException when any error occurs
+     * @return the element created
+     */    
     public Object createDynamicElement(String name) throws BuildException;
 }

src/main/org/apache/tools/ant/ExitException.java

@@ -75,7 +75,9 @@ public class ExitException extends SecurityException {
     }
 
     /**
-     * @return the status code return via System.exit()
+     * The status code returned by System.exit()
+     *
+     * @return the status code returned by System.exit()
      */
     public int getStatus() {
         return status;

src/main/org/apache/tools/ant/IntrospectionHelper.java

@@ -55,13 +55,13 @@
 package org.apache.tools.ant;
 
 import org.apache.tools.ant.DynamicConfigurator;
-import org.apache.tools.ant.types.Path;
 import org.apache.tools.ant.types.EnumeratedAttribute;
+import org.apache.tools.ant.types.Path;
 
-import java.lang.reflect.Method;
-import java.lang.reflect.InvocationTargetException;
-import java.lang.reflect.Constructor;
 import java.io.File;
+import java.lang.reflect.Constructor;
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
 import java.util.Enumeration;
 import java.util.Hashtable;
 import java.util.Locale;
@@ -890,16 +890,44 @@ public class IntrospectionHelper implements BuildListener {
         helpers.clear();
     }
 
-    /** Empty implementation to satisfy the BuildListener interface. */
+    /**
+     * Empty implementation to satisfy the BuildListener interface.
+     * @param event Ignored in this implementation.
+     */
     public void buildStarted(BuildEvent event) {}
-    /** Empty implementation to satisfy the BuildListener interface. */
+    
+    /**
+     * Empty implementation to satisfy the BuildListener interface.
+     *
+     * @param event Ignored in this implementation.
+     */
     public void targetStarted(BuildEvent event) {}
-    /** Empty implementation to satisfy the BuildListener interface. */
+    
+    /**
+     * Empty implementation to satisfy the BuildListener interface.
+     *
+     * @param event Ignored in this implementation.
+     */
     public void targetFinished(BuildEvent event) {}
-    /** Empty implementation to satisfy the BuildListener interface. */
+    
+    /**
+     * Empty implementation to satisfy the BuildListener interface.
+     *
+     * @param event Ignored in this implementation.
+     */
     public void taskStarted(BuildEvent event) {}
-    /** Empty implementation to satisfy the BuildListener interface. */
+    
+    /**
+     * Empty implementation to satisfy the BuildListener interface.
+     *
+     * @param event Ignored in this implementation.
+     */
     public void taskFinished(BuildEvent event) {}
-    /** Empty implementation to satisfy the BuildListener interface. */
+    
+    /**
+     * Empty implementation to satisfy the BuildListener interface.
+     *
+     * @param event Ignored in this implementation.
+     */
     public void messageLogged(BuildEvent event) {}
 }