Javadoc cleanups.

Author: Gary Gregory

src/main/java/org/apache/commons/io/comparator/ReverseFileComparator.java

@@ -21,8 +21,7 @@
 import java.util.Comparator;
 
 /**
- * Reverses the result of comparing two objects using
- * the delegate {@link Comparator}.
+ * Reverses the result of comparing two {@link File} objects using the delegate {@link Comparator}.
  *
  * @since 1.4
  */
@@ -34,7 +33,7 @@ class ReverseFileComparator extends AbstractFileComparator implements Serializab
     /**
      * Construct an instance with the specified delegate {@link Comparator}.
      *
-     * @param delegate The comparator to delegate to
+     * @param delegate The comparator to delegate to.
      */
     public ReverseFileComparator(final Comparator<File> delegate) {
         if (delegate == null) {
@@ -44,22 +43,22 @@ public ReverseFileComparator(final Comparator<File> delegate) {
     }
 
     /**
-     * Compare using the delegate Comparator, but reversing the result.
+     * Compares using the delegate Comparator, reversing the result.
      *
-     * @param file1 The first file to compare
-     * @param file2 The second file to compare
-     * @return the result from the delegate {@link Comparator#compare(Object, Object)}
-     * reversing the value (i.e. positive becomes negative and vice versa)
+     * @param file1 The first file to compare.
+     * @param file2 The second file to compare.
+     * @return the result from the delegate {@link Comparator#compare(Object, Object)} reversing the value (i.e.
+     *         positive becomes negative and vice versa).
      */
     @Override
     public int compare(final File file1, final File file2) {
         return delegate.compare(file2, file1); // parameters switched round
     }
 
     /**
-     * String representation of this file comparator.
+     * Returns the String representation of this file comparator.
      *
-     * @return String representation of this file comparator
+     * @return String representation of this file comparator.
      */
     @Override
     public String toString() {