Fixed up JavaDocs so they build without errors. The main changes were:

o Capitalisation. Please capitalise the first word of a new sentence, otherwise break-iterator complains.
o @created tags. These aren't valid JavaDoc, and the info is in CVS anyway...


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

src/main/org/apache/tools/ant/filters/StringInputStream.java

@@ -61,7 +61,6 @@ import java.io.StringReader;
  * Wrap a String as an InputStream
  *
  * @author <a href="mailto:umagesh@apache.org">Magesh Umasankar</a>
- * @created 20 February 2002
  */
 public class StringInputStream
     extends InputStream

src/main/org/apache/tools/ant/filters/util/ChainReaderHelper.java

@@ -74,7 +74,6 @@ import java.util.Vector;
  * Process a FilterReader chain.
  *
  * @author <a href="mailto:umagesh@apache.org">Magesh Umasankar</a>
- * @created 23 February 2002
  */
 public final class ChainReaderHelper {
 

src/main/org/apache/tools/ant/taskdefs/Manifest.java

@@ -107,8 +107,8 @@ public class Manifest extends Task {
     public static final int MAX_LINE_LENGTH = 72;
     
     /** 
-     * Max length of a line section which is continued. need to allow 
-     * for the CRLF
+     * Max length of a line section which is continued. Need to allow 
+     * for the CRLF.
      */
     public static final int MAX_SECTION_LENGTH = MAX_LINE_LENGTH - 2;
 

src/main/org/apache/tools/ant/taskdefs/optional/jsp/JspC.java

@@ -330,7 +330,7 @@ public class JspC extends MatchingTask
     }
     
     /**
-     *  web apps param. only one is allowed.
+     * Web apps parameter. Only one is allowed.
      *
      * @param  fs  add a web app fileset
      */
@@ -350,7 +350,7 @@ public class JspC extends MatchingTask
     }
 
     /**
-     *  set the compiler. optional: default=jasper
+     * Sets the compiler to use. Optional: default=jasper
      */
     public void setCompiler(String compiler) {
         this.compilerName=compiler;
@@ -512,7 +512,8 @@ public class JspC extends MatchingTask
     }
 
     /**
-     * test for compilation needed. true means yes, false means
+     * Test whether or not compilation is needed. A return value of 
+     * <code>true<code> means yes, <code>false</code> means
      * our tests do not indicate this, but as the TLDs are
      * not used for dependency checking this is not guaranteed.
      * The current tests are

src/main/org/apache/tools/ant/taskdefs/optional/jsp/JspNameMangler.java

@@ -56,12 +56,12 @@ import java.io.File;
 import java.io.IOException;
 
 /**
- * this is a class derived from the Jasper code to map from a JSP filename
- * to a valid java classname.
+ * This is a class derived from the Jasper code 
+ * (org.apache.jasper.compiler.CommandLineCompiler) to map from a JSP filename
+ * to a valid Java classname.
  *
  * @author Steve Loughran
  * @author Danno Ferrin
- * @see org.apache.jasper.compiler.CommandLineCompiler;
  */
 public class JspNameMangler implements JspMangler {
 

src/main/org/apache/tools/ant/taskdefs/optional/vss/MSVSSADD.java

@@ -184,7 +184,7 @@ public class MSVSSADD extends MSVSS {
     }
 
     /**
-     * Set the comment to apply in SourceSafe
+     * Sets the comment to apply in SourceSafe.
      * <p>
      * If this is null or empty, it will be replaced with "-" which
      * is what SourceSafe uses for an empty comment.

src/main/org/apache/tools/ant/taskdefs/optional/vss/MSVSSCREATE.java

@@ -171,7 +171,7 @@ public class MSVSSCREATE extends MSVSS {
     }
 
     /**
-     * Set the comment to apply in SourceSafe
+     * Sets the comment to apply in SourceSafe.
      * <p>
      * If this is null or empty, it will be replaced with "-" which
      * is what SourceSafe uses for an empty comment.

src/main/org/apache/tools/ant/types/XMLCatalog.java

@@ -70,7 +70,7 @@ import org.apache.tools.ant.util.LoaderUtils;
 import org.apache.tools.ant.util.FileUtils;
 
 /**
- * This data type provides a catalog of DTD locations
+ * This data type provides a catalog of DTD locations.
  * <p>
  * <code>
  * &lt;catalog&gt;<br>

src/main/org/apache/tools/ant/util/LoaderUtils.java

@@ -62,7 +62,6 @@ import org.apache.tools.ant.BuildException;
  * ClassLoader utility methods
  *
  * @author Conor MacNeill
- * @created 11 March 2002
  */
 public class LoaderUtils {
     /** The getContextClassLoader method */

src/main/org/apache/tools/ant/util/depend/AbstractAnalyzer.java

@@ -64,7 +64,6 @@ import org.apache.tools.ant.types.Path;
  * for the bulk of interface methods.
  *
  * @author Conor MacNeill
- * @created 13 March 2002
  */
 public abstract class AbstractAnalyzer implements DependencyAnalyzer {
     /** Maximum number of loops for looking for indirect dependencies. */

src/main/org/apache/tools/ant/util/depend/DependencyAnalyzer.java

@@ -68,7 +68,6 @@ import org.apache.tools.ant.types.Path;
  * generic configure method
  *
  * @author Conor MacNeill
- * @created 13 March 2002
  */
 public interface DependencyAnalyzer {
     /**

src/main/org/apache/tools/ant/util/depend/bcel/AncestorAnalyzer.java

@@ -66,7 +66,6 @@ import org.apache.tools.ant.util.depend.AbstractAnalyzer;
  * dependencies.
  *
  * @author Conor MacNeill
- * @created 13 March 2002
  */
 public class AncestorAnalyzer extends AbstractAnalyzer {
     /**

src/main/org/apache/tools/ant/util/depend/bcel/DependencyVisitor.java

@@ -68,7 +68,6 @@ import org.apache.bcel.classfile.Method;
  *
  * @author Conor MacNeill
  * @author <a href="mailto:hengels@innovidata.com">Holger Engels</a>
- * @created 15 March 2002
  */
 public class DependencyVisitor extends EmptyVisitor {
     /** The collectd dependencies */
@@ -171,7 +170,8 @@ public class DependencyVisitor extends EmptyVisitor {
     }
 
     /**
-     * Add a class name in slash format (e.g. org/apache/tools/ant/...)
+     * Adds a class name in slash format 
+     * (for example org/apache/tools/ant/Main).
      *
      * @param classname the class name in slash format
      */

src/main/org/apache/tools/ant/util/depend/bcel/FullAnalyzer.java

@@ -67,7 +67,6 @@ import org.apache.tools.ant.util.depend.AbstractAnalyzer;
  *
  * @author Conor MacNeill
  * @author <a href="mailto:hengels@innovidata.com">Holger Engels</a>
- * @created 13 March 2002
  */
 public class FullAnalyzer extends AbstractAnalyzer {
     /**