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