- @param, @return should not end with a dot, except a case when more than one sentences are used.
 - Description of the class/method/field should be followed by dot.
 - Incorrect links or typos should be fixed
 - 80 column limit.
 - empty line after description/before the first tag.
 - sets of spaces in the middle of text were deleted.
 - @param, @throws, @return should be aligned, to be more readable.
 - <tag> should be replaced by {@tag }.
 - unnecessary imports should be removed.
 - @see tags can be simplified in some places.

The full specdiff: http://cr.openjdk.java.net/~serb/8050852/javadoc/overview-summary.html
Webrev can be found at: http://cr.openjdk.java.net/~serb/8050852/webrev.02