[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