[IO-343] org.apache.commons.io.comparator Javadoc is inconsistent with real code.

Fix Javadoc to agree with code


git-svn-id: https://svn.apache.org/repos/asf/commons/proper/io/trunk@1469107 13f79535-47bb-0310-9956-ffa450edef68

Author: sebbASF

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

@@ -33,8 +33,8 @@
  * <pre>
  *       CompositeFileComparator comparator =
  *                       new CompositeFileComparator(
- *                                   DirectoryFileComparator.DIRECTORY_COMPARATOR,
- *                                   NameFileComparator.NAME_COMPARATOR);
+ *                                 (AbstractFileComparator) DirectoryFileComparator.DIRECTORY_COMPARATOR,
+ *                                 (AbstractFileComparator) NameFileComparator.NAME_COMPARATOR);
  *       List&lt;File&gt; list = ...
  *       comparator.sort(list);
  * </pre>

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

@@ -30,14 +30,14 @@
  * {@link #DEFAULT_COMPARATOR} singleton instance:
  * <pre>
  *       List&lt;File&gt; list = ...
- *       DefaultFileComparator.DEFAULT_COMPARATOR.sort(list);
+ *       ((AbstractFileComparator) DefaultFileComparator.DEFAULT_COMPARATOR).sort(list);
  * </pre>
  * <p>
  * Example of doing a <i>reverse</i> sort of an array of files using the
  * {@link #DEFAULT_REVERSE} singleton instance:
  * <pre>
  *       File[] array = ...
- *       DefaultFileComparator.DEFAULT_REVERSE.sort(array);
+ *       ((AbstractFileComparator) DefaultFileComparator.DEFAULT_REVERSE).sort(array);
  * </pre>
  * <p>
  *

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

@@ -29,14 +29,14 @@
  * {@link #DIRECTORY_COMPARATOR} singleton instance:
  * <pre>
  *       List&lt;File&gt; list = ...
- *       DirectoryFileComparator.DIRECTORY_COMPARATOR.sort(list);
+ *       ((AbstractFileComparator) DirectoryFileComparator.DIRECTORY_COMPARATOR).sort(list);
  * </pre>
  * <p>
  * Example of doing a <i>reverse</i> sort of an array of files/directories using the
  * {@link #DIRECTORY_REVERSE} singleton instance:
  * <pre>
  *       File[] array = ...
- *       DirectoryFileComparator.DIRECTORY_REVERSE.sort(array);
+ *       ((AbstractFileComparator) DirectoryFileComparator.DIRECTORY_REVERSE).sort(array);
  * </pre>
  * <p>
  *

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

@@ -37,14 +37,14 @@
  * {@link #EXTENSION_COMPARATOR} singleton instance:
  * <pre>
  *       List&lt;File&gt; list = ...
- *       ExtensionFileComparator.EXTENSION_COMPARATOR.sort(list);
+ *       ((AbstractFileComparator) ExtensionFileComparator.EXTENSION_COMPARATOR).sort(list);
  * </pre>
  * <p>
  * Example of a <i>reverse case-insensitive</i> file extension sort using the
  * {@link #EXTENSION_INSENSITIVE_REVERSE} singleton instance:
  * <pre>
  *       File[] array = ...
- *       ExtensionFileComparator.EXTENSION_INSENSITIVE_REVERSE.sort(array);
+ *       ((AbstractFileComparator) ExtensionFileComparator.EXTENSION_INSENSITIVE_REVERSE).sort(array);
  * </pre>
  * <p>
  *

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

@@ -31,14 +31,14 @@
  * {@link #LASTMODIFIED_COMPARATOR} singleton instance:
  * <pre>
  *       List&lt;File&gt; list = ...
- *       LastModifiedFileComparator.LASTMODIFIED_COMPARATOR.sort(list);
+ *       ((AbstractFileComparator) LastModifiedFileComparator.LASTMODIFIED_COMPARATOR).sort(list);
  * </pre>
  * <p>
  * Example of doing a <i>reverse</i> sort of an array of files using the
  * {@link #LASTMODIFIED_REVERSE} singleton instance:
  * <pre>
  *       File[] array = ...
- *       LastModifiedFileComparator.LASTMODIFIED_REVERSE.sort(array);
+ *       ((AbstractFileComparator) LastModifiedFileComparator.LASTMODIFIED_REVERSE).sort(array);
  * </pre>
  * <p>
  *

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

@@ -35,14 +35,14 @@
  * {@link #NAME_COMPARATOR} singleton instance:
  * <pre>
  *       List&lt;File&gt; list = ...
- *       NameFileComparator.NAME_COMPARATOR.sort(list);
+ *       ((AbstractFileComparator) NameFileComparator.NAME_COMPARATOR).sort(list);
  * </pre>
  * <p>
  * Example of a <i>reverse case-insensitive</i> file name sort using the
  * {@link #NAME_INSENSITIVE_REVERSE} singleton instance:
  * <pre>
  *       File[] array = ...
- *       NameFileComparator.NAME_INSENSITIVE_REVERSE.sort(array);
+ *       ((AbstractFileComparator) NameFileComparator.NAME_INSENSITIVE_REVERSE).sort(array);
  * </pre>
  * <p>
  *

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

@@ -35,14 +35,14 @@
  * {@link #PATH_COMPARATOR} singleton instance:
  * <pre>
  *       List&lt;File&gt; list = ...
- *       PathFileComparator.PATH_COMPARATOR.sort(list);
+ *       ((AbstractFileComparator) PathFileComparator.PATH_COMPARATOR).sort(list);
  * </pre>
  * <p>
  * Example of a <i>reverse case-insensitive</i> file path sort using the
  * {@link #PATH_INSENSITIVE_REVERSE} singleton instance:
  * <pre>
  *       File[] array = ...
- *       PathFileComparator.PATH_INSENSITIVE_REVERSE.sort(array);
+ *       ((AbstractFileComparator) PathFileComparator.PATH_INSENSITIVE_REVERSE).sort(array);
  * </pre>
  * <p>
  *

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

@@ -33,14 +33,14 @@
  * {@link #SIZE_COMPARATOR} singleton instance:
  * <pre>
  *       List&lt;File&gt; list = ...
- *       SizeFileComparator.SIZE_COMPARATOR.sort(list);
+ *       ((AbstractFileComparator) SizeFileComparator.SIZE_COMPARATOR).sort(list);
  * </pre>
  * <p>
  * Example of doing a <i>reverse</i> sort of an array of files using the
  * {@link #SIZE_REVERSE} singleton instance:
  * <pre>
  *       File[] array = ...
- *       SizeFileComparator.SIZE_REVERSE.sort(array);
+ *       ((AbstractFileComparator) SizeFileComparator.SIZE_REVERSE).sort(array);
  * </pre>
  * <p>
  * <strong>N.B.</strong> Directories are treated as <b>zero size</b> unless