make JavaDoc more happier

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

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

@@ -393,7 +393,7 @@ public abstract class JDBCTask extends Task {
 
 
     /**
-     * Set the caching attribute. (!)
+     * Set the caching attribute.
      * @param value a <code>boolean</code> value
      */
     public void isCaching(boolean value) {
@@ -464,4 +464,4 @@ public abstract class JDBCTask extends Task {
         return version;
     }
 
-}
+}

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

@@ -49,7 +49,7 @@ public class LogOutputStream extends LineOrientedOutputStream {
     /**
      * Creates a new instance of this class.
      *
-     * @param task the task for whom to log
+     * @param pc the project component for whom to log
      * @param level loglevel used to log data written to this stream.
      * @since Ant 1.6.3
      */
@@ -92,4 +92,4 @@ public class LogOutputStream extends LineOrientedOutputStream {
         return level;
     }
 
-}
+}

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

@@ -239,7 +239,7 @@ public class RecorderEntry implements BuildLogger, SubBuildListener {
 
 
     /**
-     * @see BuildLogger#setEmacMode(boolean)
+     * @see BuildLogger#setEmacsMode(boolean)
      */
     public void setEmacsMode(boolean emacsMode) {
         this.emacsMode = emacsMode;
@@ -342,4 +342,3 @@ public class RecorderEntry implements BuildLogger, SubBuildListener {
     }
 
 }
-

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

@@ -106,7 +106,7 @@ public class ResourceCount extends Task implements Condition {
 
     /**
      * Set the comparison for use as a Condition.
-     * @param w EnumeratedAttribute When.
+     * @param c Comparison (an EnumeratedAttribute) When.
      * @see org.apache.tools.ant.types.Comparison
      */
     public void setWhen(Comparison c) {
@@ -121,4 +121,4 @@ public class ResourceCount extends Task implements Condition {
         property = p;
     }
 
-}
+}

src/main/org/apache/tools/ant/taskdefs/optional/XMLValidateTask.java

@@ -318,7 +318,7 @@ public class XMLValidateTask extends Task {
 
     /**
      * handler called on successful file validation.
-     * @param fileProcessed number of files processed. 
+     * @param fileProcessed number of files processed.
      */
     protected void onSuccessfulValidation(int fileProcessed) {
         log(fileProcessed + MESSAGE_FILES_VALIDATED);
@@ -370,7 +370,7 @@ public class XMLValidateTask extends Task {
      * falling back to a default reader if not.
      * If the returned reader is an instance of {@link ParserAdapter} then
      * we have created and wrapped a SAX1 parser.
-     * @returns the new XMLReader.
+     * @return the new XMLReader.
      */
     protected XMLReader createXmlReader() {
         Object reader = null;
@@ -729,4 +729,4 @@ public class XMLValidateTask extends Task {
 
 
 
-}
+}

src/main/org/apache/tools/ant/taskdefs/optional/dotnet/NetCommand.java

@@ -205,7 +205,7 @@ public class NetCommand {
      *  add an argument to a command line; do nothing if the arg is null or
      *  empty string
      *
-     *@param  argument  The feature to be added to the Argument attribute
+     *@param  arguments  The features to be added to the Argument attribute
      */
     public void addArguments(String[] arguments) {
         if (arguments != null && arguments.length != 0) {
@@ -397,4 +397,3 @@ public class NetCommand {
         return filesOutOfDate;
     }
 }
-

src/main/org/apache/tools/ant/taskdefs/optional/dotnet/WsdlToDotnet.java

@@ -203,7 +203,7 @@ public class WsdlToDotnet extends Task  {
     }
 
     /**
-     * Should errors be machine parseable?
+     * Defines wether errors are machine parseable.
      * Optional, default=true
      *
      * @since Ant 1.7
@@ -558,4 +558,3 @@ public class WsdlToDotnet extends Task  {
     }
 
 }
-

src/main/org/apache/tools/ant/taskdefs/optional/net/FTP.java

@@ -89,11 +89,11 @@ public class FTP
     protected static final int SITE_CMD = 7;
     /** return code of ftp - not implemented in commons-net version 1.0 */
     private static final int CODE_521 = 521;
-    
+
     /** adjust uptodate calculations where server timestamps are HH:mm and client's
      * are HH:mm:ss */
     private static final long GRANULARITY_MINUTE = 60000L;
-    
+
     /** Default port for FTP */
     public static final int DEFAULT_FTP_PORT = 21;
 
@@ -223,7 +223,7 @@ public class FTP
                 String cwd = ftp.printWorkingDirectory();
                 // always start from the current ftp working dir
                 forceRemoteSensitivityCheck();
-                
+
                 checkIncludePatterns();
                 clearCaches();
                 ftp.changeWorkingDirectory(cwd);
@@ -539,7 +539,7 @@ public class FTP
             }
             return result;
         }
-        
+
         private void forceRemoteSensitivityCheck()
         {
             if (!remoteSensitivityChecked) {
@@ -897,7 +897,7 @@ public class FTP
                 }
                 return traversesSymlinks;
             }
-            
+
             public String toString() {
                 return "AntFtpFile: "+curpwd+"%"+ftpFile;
             }
@@ -1278,8 +1278,8 @@ public class FTP
     /**
      * Sets the systemTypeKey attribute.
      * Method for setting <code>FTPClientConfig</code> remote system key.
-     * 
-     * @param systemTypeKey the key to be set - BUT if blank 
+     *
+     * @param systemKey the key to be set - BUT if blank
      * the default value of null (which signifies "autodetect") will be kept.
      * @see org.apache.commons.net.ftp.FTPClientConfig
      */
@@ -1293,7 +1293,7 @@ public class FTP
 
     /**
      * Sets the defaultDateFormatConfig attribute.
-     * @param defaultDateFormatConfig configuration to be set, unless it is
+     * @param defaultDateFormat configuration to be set, unless it is
      * null or empty string, in which case ignored.
      * @see org.apache.commons.net.ftp.FTPClientConfig
      */
@@ -1307,7 +1307,7 @@ public class FTP
 
     /**
      * Sets the recentDateFormatConfig attribute.
-     * @param recentDateFormatConfig configuration to be set, unless it is
+     * @param recentDateFormat configuration to be set, unless it is
      * null or empty string, in which case ignored.
      * @see org.apache.commons.net.ftp.FTPClientConfig
      */
@@ -1321,7 +1321,7 @@ public class FTP
 
     /**
      * Sets the serverLanguageCode attribute.
-     * @param serverLanguageCodeConfig configuration to be set, unless it is
+     * @param serverLanguageCode configuration to be set, unless it is
      * null or empty string, in which case ignored.
      * @see org.apache.commons.net.ftp.FTPClientConfig
      */
@@ -1335,7 +1335,7 @@ public class FTP
 
     /**
      * Sets the serverTimeZoneConfig attribute.
-     * @param serverTimeZoneConfig configuration to be set, unless it is
+     * @param serverTimeZoneId configuration to be set, unless it is
      * null or empty string, in which case ignored.
      * @see org.apache.commons.net.ftp.FTPClientConfig
      */
@@ -1349,8 +1349,8 @@ public class FTP
 
     /**
      * Sets the shortMonthNamesConfig attribute
-     * 
-     * @param shortMonthNamesConfig configuration to be set, unless it is
+     *
+     * @param shortMonthNames configuration to be set, unless it is
      * null or empty string, in which case ignored.
      * @see org.apache.commons.net.ftp.FTPClientConfig
      */
@@ -1365,11 +1365,11 @@ public class FTP
 
 
     /**
-     * How many times to retry executing FTP command before giving up?
+     * Defines how many times to retry executing FTP command before giving up.
      * Default is 0 - try once and if failure then give up.
-     * 
+     *
      * @param retriesAllowed number of retries to allow.  -1 means
-     * keep trying forever. "forever" may also be specified as a 
+     * keep trying forever. "forever" may also be specified as a
      * synonym for -1.
      */
     public void setRetriesAllowed(String retriesAllowed) {
@@ -1380,18 +1380,18 @@ public class FTP
                 int retries = Integer.parseInt(retriesAllowed);
                 if (retries < Retryable.RETRY_FOREVER) {
                     throw new BuildException(
-                            "Invalid value for retriesAllowed attribute: " 
+                            "Invalid value for retriesAllowed attribute: "
                             + retriesAllowed);
 
                 }
                 this.retriesAllowed = retries;
             } catch (NumberFormatException px) {
                 throw new BuildException(
-                        "Invalid value for retriesAllowed attribute: " 
+                        "Invalid value for retriesAllowed attribute: "
                         + retriesAllowed);
-             
+
             }
-            
+
         }
     }
     /**
@@ -1458,8 +1458,8 @@ public class FTP
     /**
      * Sets the initialSiteCommand attribute.  This attribute
      * names a site command that will be executed immediately
-     * after connection. 
-     * @param initialSiteCommand The initialSiteCommand to set.
+     * after connection.
+     * @param initialCommand The initialSiteCommand to set.
      */
     public void setInitialSiteCommand(String initialCommand) {
         this.initialSiteCommand = initialCommand;
@@ -1499,7 +1499,7 @@ public class FTP
                  + "action!");
         }
 
-        
+
         if (this.isConfigurationSet) {
             try {
                 Class.forName("org.apache.commons.net.ftp.FTPClientConfig");
@@ -1509,8 +1509,8 @@ public class FTP
             }
         }
     }
-    
-    protected void executeRetryable(RetryHandler h, Retryable r, String descr) 
+
+    protected void executeRetryable(RetryHandler h, Retryable r, String descr)
     throws IOException
     {
         h.execute(r, descr);
@@ -1592,7 +1592,7 @@ public class FTP
                 final BufferedWriter fbw = bw;
                 final String fdir = dir;
                 if (this.newerOnly) {
-                    this.granularityMillis = 
+                    this.granularityMillis =
                         this.timestampGranularity.getMilliseconds(action);
                 }
                 for (int i = 0; i < dsfiles.length; i++) {
@@ -1819,10 +1819,10 @@ public class FTP
         }
         return null;
     }
-    
-    private static final SimpleDateFormat TIMESTAMP_LOGGING_SDF = 
+
+    private static final SimpleDateFormat TIMESTAMP_LOGGING_SDF =
         new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
-    
+
     /**
      * Checks to see if the remote file is current as compared with the local
      * file. Returns true if the target file is up to date.
@@ -1859,26 +1859,26 @@ public class FTP
 
         long remoteTimestamp = files[0].getTimestamp().getTime().getTime();
         long localTimestamp = localFile.lastModified();
-        long adjustedRemoteTimestamp = 
-            remoteTimestamp + this.timeDiffMillis + this.granularityMillis; 
-        
+        long adjustedRemoteTimestamp =
+            remoteTimestamp + this.timeDiffMillis + this.granularityMillis;
+
         StringBuffer msg = new StringBuffer("   [")
-        	.append(TIMESTAMP_LOGGING_SDF.format(new Date(localTimestamp)))
-        	.append("] local");
+                .append(TIMESTAMP_LOGGING_SDF.format(new Date(localTimestamp)))
+                .append("] local");
         log(msg.toString(), Project.MSG_VERBOSE);
-        
+
         msg = new StringBuffer("   [")
-          	.append(TIMESTAMP_LOGGING_SDF.format(new Date(adjustedRemoteTimestamp)))
-        	.append("] remote");
+                  .append(TIMESTAMP_LOGGING_SDF.format(new Date(adjustedRemoteTimestamp)))
+                .append("] remote");
         if (remoteTimestamp != adjustedRemoteTimestamp) {
             msg.append(" - (raw: ")
-        	.append(TIMESTAMP_LOGGING_SDF.format(new Date(remoteTimestamp)))
+                .append(TIMESTAMP_LOGGING_SDF.format(new Date(remoteTimestamp)))
             .append(")");
         }
         log(msg.toString(), Project.MSG_VERBOSE);
-        
 
-        
+
+
         if (this.action == SEND_FILES) {
             return adjustedRemoteTimestamp >= localTimestamp;
         } else {
@@ -2281,7 +2281,7 @@ public class FTP
                          + "mode: " + ftp.getReplyString());
                 }
             }
-            
+
             // If an initial command was configured then send it.
             // Some FTP servers offer different modes of operation,
             // E.G. switching between a UNIX file system mode and
@@ -2415,26 +2415,26 @@ public class FTP
         }
     }
     /**
-     * represents one of the valid timestamp adjustment values 
+     * represents one of the valid timestamp adjustment values
      * recognized by the <code>timestampGranularity</code> attribute.<p>
 
-     * A timestamp adjustment may be used in file transfers for checking 
-     * uptodateness. MINUTE means to add one minute to the server 
-     * timestamp.  This is done because FTP servers typically list 
+     * A timestamp adjustment may be used in file transfers for checking
+     * uptodateness. MINUTE means to add one minute to the server
+     * timestamp.  This is done because FTP servers typically list
      * timestamps HH:mm and client FileSystems typically use HH:mm:ss.
-     * 
-     * The default is to use MINUTE for PUT actions and NONE for GET 
+     *
+     * The default is to use MINUTE for PUT actions and NONE for GET
      * actions, since GETs have the <code>preserveLastModified</code>
      * option, which takes care of the problem in most use cases where
      * this level of granularity is an issue.
-     * 
+     *
      */
     public static class Granularity extends EnumeratedAttribute {
 
         private static final String[] VALID_GRANULARITIES = {
                 "", "MINUTE", "NONE"
         };
-         /* 
+         /*
          * @return the list of valid Granularity values
          */
         public String[] getValues() {
@@ -2442,11 +2442,11 @@ public class FTP
             return VALID_GRANULARITIES;
         }
         /**
-         * returns the number of milliseconds associated with 
+         * returns the number of milliseconds associated with
          * the attribute, which can vary in some cases depending
          * on the value of the action parameter.
          * @param action SEND_FILES or GET_FILES
-         * @return the number of milliseconds associated with 
+         * @return the number of milliseconds associated with
          * the attribute, in the context of the supplied action
          */
         public long getMilliseconds(int action) {
@@ -2454,51 +2454,51 @@ public class FTP
             long granularity = 0L;
             if ("".equals(granularityU)) {
                 if (action == SEND_FILES) {
-                    return GRANULARITY_MINUTE;                   
+                    return GRANULARITY_MINUTE;
                 }
             } else if ("MINUTE".equals(granularityU)) {
                 return GRANULARITY_MINUTE;
-        	}  
-        	return 0L;
+                }
+                return 0L;
         }
         static final Granularity getDefault() {
             Granularity g = new Granularity();
             g.setValue("");
             return g;
         }
-        
+
    }
    /**
-	 * one of the valid system type keys recognized by the systemTypeKey
-	 * attribute.
-	 */
+         * one of the valid system type keys recognized by the systemTypeKey
+         * attribute.
+         */
     public static class FTPSystemType extends EnumeratedAttribute {
 
        private static final String[] VALID_SYSTEM_TYPES = {
-	           "", "UNIX", "VMS", "WINDOWS", "OS/2", "OS/400",
-	           "MVS"
-	   };
-       
-       
-	    /* 
-	     * @return the list of valid system types.
-	     */
-	    public String[] getValues() {
-	        return VALID_SYSTEM_TYPES;
-	    }
-	    
-	    static final FTPSystemType getDefault() {
-	        FTPSystemType ftpst = new FTPSystemType();
-	        ftpst.setValue("");
-	        return ftpst;
-	    }
+                   "", "UNIX", "VMS", "WINDOWS", "OS/2", "OS/400",
+                   "MVS"
+           };
+
+
+            /*
+             * @return the list of valid system types.
+             */
+            public String[] getValues() {
+                return VALID_SYSTEM_TYPES;
+            }
+
+            static final FTPSystemType getDefault() {
+                FTPSystemType ftpst = new FTPSystemType();
+                ftpst.setValue("");
+                return ftpst;
+            }
     }
     public static class LanguageCode extends EnumeratedAttribute {
 
-        
-        private static final String[] VALID_LANGUAGE_CODES = 
+
+        private static final String[] VALID_LANGUAGE_CODES =
             getValidLanguageCodes();
- 	   
+
         private static final String[] getValidLanguageCodes() {
             Collection c = FTPClientConfig.getSupportedLanguageCodes();
             String[] ret = new String[c.size() + 1];
@@ -2507,23 +2507,22 @@ public class FTP
             for (Iterator it = c.iterator(); it.hasNext(); i++) {
                 ret[i] = (String) it.next();
             }
-            return ret; 
-        }
-        
-        
- 	    /* 
- 	     * @return the list of valid system types.
- 	     */
- 	    public String[] getValues() {
- 	        return VALID_LANGUAGE_CODES;
- 	    }
- 	    
- 	    static final LanguageCode getDefault() {
- 	        LanguageCode lc = new LanguageCode();
- 	        lc.setValue("");
- 	        return lc;
- 	    }
-     }
+            return ret;
+        }
+
 
-}
+             /*
+              * @return the list of valid system types.
+              */
+             public String[] getValues() {
+                 return VALID_LANGUAGE_CODES;
+             }
+
+             static final LanguageCode getDefault() {
+                 LanguageCode lc = new LanguageCode();
+                 lc.setValue("");
+                 return lc;
+             }
+     }
 
+}

src/main/org/apache/tools/ant/taskdefs/optional/sitraka/CovReport.java

@@ -123,7 +123,7 @@ public class CovReport extends CovBase {
 
     /** Enumerated type for format attribute. */
     public static class ReportFormat extends EnumeratedAttribute {
-        /** @see EnumeratedAttribute@getValues() */
+        /** @see EnumeratedAttribute#getValues() */
         public String[] getValues() {
             return new String[]{"html", "text", "xml"};
         }
@@ -139,7 +139,7 @@ public class CovReport extends CovBase {
 
     /** Enumerated type for type attribute. */
     public static class ReportType extends EnumeratedAttribute {
-        /** @see EnumeratedAttribute@getValues() */
+        /** @see EnumeratedAttribute#getValues() */
         public String[] getValues() {
             return new String[]{"executive", "summary", "detailed", "verydetailed"};
         }
@@ -407,4 +407,4 @@ public class CovReport extends CovBase {
             }
         }
     }
-}
+}

src/main/org/apache/tools/ant/taskdefs/optional/ssh/SSHExec.java

@@ -33,9 +33,7 @@ import com.jcraft.jsch.Session;
 
 /**
  * Executes a command on a remote machine via ssh.
- *
- * @created   February 2, 2003
- * @since     Ant 1.6
+ * @since     Ant 1.6 (created February 2, 2003)
  */
 public class SSHExec extends SSHBase {
 
@@ -261,4 +259,3 @@ public class SSHExec extends SSHBase {
     }
 
 }
-

src/main/org/apache/tools/ant/taskdefs/repository/HttpRepository.java

@@ -33,7 +33,7 @@ import java.net.URL;
  *
  * Although it is biased towards HTTP, because the underlying <get> task
  * supports different protocols, one is actually able to use other protocols
- * such as ftp: or file: to retrieve content. 
+ * such as ftp: or file: to retrieve content.
  *
  * @since Ant1.7
  */
@@ -189,7 +189,7 @@ public abstract class HttpRepository extends Repository {
 
     /**
      * Test for a repository being reachable. This method is called after {@link
-     * #connect(org.apache.tools.ant.taskdefs.repository.GetLibraries)}
+     * #connect(org.apache.tools.ant.taskdefs.repository.Libraries)}
      * is called, before any files are to be retrieved.
      * <p/>
      * If it returns false the repository considers itself offline. Similarly,
@@ -302,4 +302,4 @@ public abstract class HttpRepository extends Repository {
     public String getRepositoryURI() {
         return "HttpRepository://" + getUrl();
     }
-}
+}

src/main/org/apache/tools/ant/taskdefs/repository/Repository.java

@@ -85,7 +85,7 @@ public abstract class Repository extends DataType {
 
     /**
      * Test for a repository being reachable. This method is called after {@link
-     * #connect(GetLibraries)} is called, before any files are to be retrieved.
+     * #connect(Libraries)} is called, before any files are to be retrieved.
      * <p/>
      * If it returns false the repository considers itself offline. Similarly,
      * any ioexception is interpreted as being offline.
@@ -113,4 +113,4 @@ public abstract class Repository extends DataType {
      * @return
      */
     public abstract String getRepositoryURI();
-}
+}

src/main/org/apache/tools/ant/taskdefs/repository/RepositoryRef.java

@@ -52,7 +52,7 @@ public final class RepositoryRef extends Repository {
 
     /**
      * Test for a repository being reachable. This method is called after {@link
-     * #connect(GetLibraries)} is called, before any files are to be retrieved.
+     * #connect(Libraries)} is called, before any files are to be retrieved.
      * <p/>
      * If it returns false the repository considers itself offline. Similarly,
      * any ioexception is interpreted as being offline.
@@ -86,4 +86,4 @@ public final class RepositoryRef extends Repository {
     public String getRepositoryURI() {
         return "ref://" + getRefid();
     }
-}
+}

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

@@ -188,8 +188,8 @@ public abstract class DataType extends ProjectComponent {
      * Allow DataTypes outside org.apache.tools.ant.types to indirectly call
      * dieOnCircularReference on nested DataTypes.
      * @param dt the DataType to check.
-     * @param stack the stack of references to check.
-     * @param project the project to use to dereference the references.
+     * @param stk the stack of references to check.
+     * @param p the project to use to dereference the references.
      * @throws BuildException on error.
      * @since Ant 1.7
      */
@@ -212,7 +212,7 @@ public abstract class DataType extends ProjectComponent {
     /**
      * Performs the check for circular references and returns the
      * referenced object.
-     * @param project the Ant Project instance against which to resolve references.
+     * @param p the Ant Project instance against which to resolve references.
      * @return the dereferenced object.
      * @throws BuildException if the reference is invalid (circular ref, wrong class, etc).
      * @since Ant 1.7
@@ -338,4 +338,4 @@ public abstract class DataType extends ProjectComponent {
             throw noChildrenAllowed();
         }
     }
-}
+}

src/main/org/apache/tools/ant/types/optional/image/ImageOperation.java

@@ -21,7 +21,7 @@ import java.util.Vector;
 
 /**
  *
- * @see org.apache.tools.ant.tasks.optional.image.Image
+ * @see org.apache.tools.ant.taskdefs.optional.image.Image
  */
 public abstract class ImageOperation extends DataType {
     protected Vector instructions = new Vector();
@@ -45,4 +45,4 @@ public abstract class ImageOperation extends DataType {
     public void addScale(Scale instr) {
         instructions.add(instr);
     }
-}
+}

src/main/org/apache/tools/ant/types/optional/image/TransformOperation.java

@@ -19,7 +19,7 @@ import javax.media.jai.PlanarImage;
 
 /**
  *
- * @see org.apache.tools.ant.tasks.optional.image.Image
+ * @see org.apache.tools.ant.taskdefs.optional.image.Image
  */
 public abstract class TransformOperation extends ImageOperation {
     public abstract PlanarImage executeTransformOperation(PlanarImage img);
@@ -28,4 +28,4 @@ public abstract class TransformOperation extends ImageOperation {
         instructions.add(instr);
     }
 
-}
+}

src/main/org/apache/tools/ant/types/resources/FileResourceIterator.java

@@ -50,7 +50,7 @@ public class FileResourceIterator implements Iterator {
      * Construct a new FileResourceIterator over the specified filenames,
      * relative to the specified base directory.
      * @param f the base directory of this instance.
-     * @param files the String[] of filenames.
+     * @param s the String[] of filenames.
      */
     public FileResourceIterator(File f, String[] s) {
         this(f);
@@ -105,4 +105,4 @@ public class FileResourceIterator implements Iterator {
         return new FileResource(basedir, files[pos++]);
     }
 
-}
+}

src/main/org/apache/tools/ant/types/resources/Restrict.java

@@ -56,7 +56,7 @@ public class Restrict
 
     /**
      * Add a ResourceSelector.
-     * @param the ResourceSelector to add.
+     * @param s the ResourceSelector to add.
      */
     public synchronized void add(ResourceSelector s) {
         super.add(s);
@@ -134,4 +134,4 @@ outer:  for (Iterator ri = rc.iterator(); ri.hasNext();) {
         return result;
     }
 
-}
+}

src/main/org/apache/tools/ant/types/resources/Touchable.java

@@ -17,10 +17,10 @@
 package org.apache.tools.ant.types.resources;
 
 /**
- * Interface to be implemented by "touchable" resources; i.e. those
- * whose modification time can be altered.
+ * Interface to be implemented by "touchable" resources;
+ * for example those whose modification time can be altered.
  * @since Ant 1.7
  */
 public interface Touchable {
     void touch(long modTime);
-}
+}

src/main/org/apache/tools/ant/types/resources/comparators/Reverse.java

@@ -32,7 +32,7 @@ public class Reverse extends ResourceComparator {
 
     /**
      * Add the ResourceComparator to reverse.
-     * @param nested the ResourceComparator to add.
+     * @param c the ResourceComparator to add.
      */
     public void add(ResourceComparator c) {
         if (nested != null) {
@@ -53,4 +53,4 @@ public class Reverse extends ResourceComparator {
             ? foo.compareTo(bar) : nested.compare(foo, bar));
     }
 
-}
+}

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

@@ -88,7 +88,7 @@ public class ConcatResourceInputStream extends InputStream {
     /**
      * Set a managing <code>ProjectComponent</code> for
      * this <code>ConcatResourceInputStream</code>.
-     * @param task   the managing <code>Task</code>.
+     * @param pc   the managing <code>ProjectComponent</code>.
      */
     public void setManagingComponent(ProjectComponent pc) {
         this.managingPc = pc;
@@ -140,4 +140,4 @@ public class ConcatResourceInputStream extends InputStream {
         FileUtils.close(currentStream);
         currentStream = null;
     }
-}
+}