Move JavaInput's comment on line ranges to InputOutput.ranges

The block comment above JavaInput's fields described "the following
lists" of tok indices on each line, which live in InputOutput.ranges,
and Error Prone's AlmostJavadoc flagged its {@code} tags. What it said
that the field's Javadoc did not, that a /* comment spans lines and
that the lists give the correspondence between input and output, is
in that Javadoc now.

Author: abashev

open-java-format/src/main/java/com/palantir/javaformat/InputOutput.java

@@ -52,7 +52,10 @@ public final String getLine(int lineI) {
         return lines.get(lineI);
     }
 
-    /** The {@link Range}s of the tokens or comments lying on each line, in any part. */
+    /**
+     * The {@link Range}s of the tokens or comments lying on each line, in any part: a {@code /*} comment can lie on
+     * several. With the same for the formatted output, they give the correspondence between input and output lines.
+     */
     protected final List<Range<Integer>> ranges = new ArrayList<>();
 
     private static void addToRanges(List<Range<Integer>> ranges, int i, int k) {

open-java-format/src/main/java/com/palantir/javaformat/java/JavaInput.java

@@ -260,14 +260,6 @@ public String toString() {
     private final Supplier<String> lineSeparator = Suppliers.memoize(() -> Newlines.guessLineSeparator(getText()));
     private int kN; // The number of numbered toks (tokens or comments), excluding the EOF.
 
-    /*
-     * The following lists record the sequential indices of the {@code Tok}s on each input line. (Only
-     * tokens and comments have sequential indices.) Tokens and {@code //} comments lie on just one
-     * line; {@code /*} comments can lie on multiple lines. These data structures (along with
-     * equivalent ones for the formatted output) let us compute correspondences between the input and
-     * output.
-     */
-
     private final Map<Integer, Integer> positionToColumnMap; // Map Tok position to column.
 
     private final List<Token> tokens; // The Tokens for this input.