Hello,
Please review the fix for jdk9.
Bug: https://bugs.openjdk.java.net/browse/JDK-8180889
Webrev can be found at: http://cr.openjdk.java.net/~serb/8180889/webrev.00
Specdiff:
http://cr.openjdk.java.net/~serb/8180889/specdiff.00/java/awt/datatransfer/package-summary.html
In jdk9 a lots of specifications and javadocs were updated, but it seems that
java.datatransfer module was missed, because the client team cleanup only the
java.desktop module.
In this fix the only javadoc is updated and the next rules were applied:
- <tag> should be replaced by {@tag }
- @deprecated tag should have some text
- 80 column limit
- description of the class/method/field should be followed by dot
- @param, @return should not end with a dot, except a case when more than one
sentences are used
- empty line after description/before the first tag was added
- unnecessary empty lines were removed
- sets of spaces in the middle of text were deleted
- @param, @throws, @return should be aligned, to be more readable
- unnecessary imports should be removed
- the "null"/"true"/"false"/"this" should be wrapped in {@code } when necessary
- the order of different tags were unified across the package
The specdiff is provided and the most visible changes are:
http://cr.openjdk.java.net/~serb/8180889/specdiff.00/java/awt/datatransfer/DataFlavor-report.html#method:normalizeMimeTypeParameter(java.lang.String,%20java.lang.String)
http://cr.openjdk.java.net/~serb/8180889/specdiff.00/java/awt/datatransfer/DataFlavor-report.html#method:normalizeMimeType(java.lang.String)
where the text about deprecation was moved to the @deprecated tag.
