Javadoc: Add missing @param

Author: garydgregory

src/main/java/org/apache/commons/io/file/PathFilter.java

@@ -33,7 +33,7 @@ public interface PathFilter {
      * Tests whether or not to include the specified Path in a result.
      *
      * @param path The Path to test.
-     * @param attributes the file's basic attributes (TODO may be null).
+     * @param attributes the path's basic attributes (may be null).
      * @return a FileVisitResult
      */
     FileVisitResult accept(Path path, BasicFileAttributes attributes);

src/main/java/org/apache/commons/io/filefilter/AgeFileFilter.java

@@ -193,8 +193,9 @@ public boolean accept(final File file) {
      * If last modification time equals cutoff and newer files are required, file <b>IS NOT</b> selected. If last
      * modification time equals cutoff and older files are required, file <b>IS</b> selected.
      * </p>
-     * @param file the File to check
      *
+     * @param file the File to check
+     * @param attributes the path's basic attributes (may be null).
      * @return true if the file name matches
      * @since 2.9.0
      */

src/main/java/org/apache/commons/io/filefilter/CanExecuteFileFilter.java

@@ -87,8 +87,9 @@ public boolean accept(final File file) {
 
     /**
      * Checks to see if the file can be executed.
-     * @param file  the File to check.
      *
+     * @param file  the File to check.
+     * @param attributes the path's basic attributes (may be null).
      * @return {@code true} if the file can be executed, otherwise {@code false}.
      * @since 2.9.0
      */

src/main/java/org/apache/commons/io/filefilter/CanReadFileFilter.java

@@ -97,8 +97,9 @@ public boolean accept(final File file) {
 
     /**
      * Checks to see if the file can be read.
-     * @param file the File to check.
      *
+     * @param file the File to check.
+     * @param attributes the path's basic attributes (may be null).
      * @return {@code true} if the file can be read, otherwise {@code false}.
      * @since 2.9.0
      */

src/main/java/org/apache/commons/io/filefilter/CanWriteFileFilter.java

@@ -85,8 +85,9 @@ public boolean accept(final File file) {
 
     /**
      * Checks to see if the file can be written to.
-     * @param file the File to check
      *
+     * @param file the File to check
+     * @param attributes the path's basic attributes (may be null).
      * @return {@code true} if the file can be written to, otherwise {@code false}.
      * @since 2.9.0
      */

src/main/java/org/apache/commons/io/filefilter/DirectoryFileFilter.java

@@ -102,8 +102,9 @@ public boolean accept(final File file) {
 
     /**
      * Checks to see if the file is a directory.
-     * @param file the File to check
      *
+     * @param file the File to check
+     * @param attributes the path's basic attributes (may be null).
      * @return true if the file is a directory
      * @since 2.9.0
      */

src/main/java/org/apache/commons/io/filefilter/EmptyFileFilter.java

@@ -116,8 +116,9 @@ public boolean accept(final File file) {
 
     /**
      * Checks to see if the file is empty.
-     * @param file the file or directory to check
      *
+     * @param file the file or directory to check
+     * @param attributes the path's basic attributes (may be null).
      * @return {@code true} if the file or directory is <em>empty</em>, otherwise {@code false}.
      * @since 2.9.0
      */

src/main/java/org/apache/commons/io/filefilter/FalseFileFilter.java

@@ -84,7 +84,7 @@ public boolean accept(final File dir, final String name) {
      * Returns false.
      *
      * @param file the file to check (ignored)
-     *
+     * @param attributes the path's basic attributes (may be null).
      * @return false
      * @since 2.9.0
      */

src/main/java/org/apache/commons/io/filefilter/FileFileFilter.java

@@ -102,8 +102,9 @@ public boolean accept(final File file) {
 
     /**
      * Checks to see if the file is a file.
-     * @param file  the File to check
      *
+     * @param file  the File to check
+     * @param attributes the path's basic attributes (may be null).
      * @return true if the file is a file
      * @since 2.9.0
      */

src/main/java/org/apache/commons/io/filefilter/HiddenFileFilter.java

@@ -106,10 +106,10 @@ public boolean accept(final File file) {
 
     /**
      * Checks to see if the file is hidden.
-     * @param file  the File to check
      *
-     * @return {@code true} if the file is
-     *  <em>hidden</em>, otherwise {@code false}.
+     * @param file       the File to check
+     * @param attributes the path's basic attributes (may be null).
+     * @return {@code true} if the file is <em>hidden</em>, otherwise {@code false}.
      * @since 2.9.0
      */
     @Override