<Swing Dev> [8] Review Request: 8029264 [doclint] more doclint and tidy cleanup

Yuri Nesterenko yuri.nesterenko at oracle.com
Mon Dec 2 14:07:53 UTC 2013


Colleagues,

please review this yet another cleanup request.
They will never end but then again, they are easy to review.

Here's the webrev:
http://cr.openjdk.java.net/~yan/8029264/webrev.00
Bug is:
https://bugs.openjdk.java.net/browse/JDK-8029264

My routine was:

increase number of allowed warnings/errors; enable doclint.
make all docs > log 2>&1
Pick up swing files to clean.

Clean, running DocLint on them repeatedly, until I only have unfixable
(for now) issues.
make all docs > log 2>&1
Pick up swing HTML files related to my original list,
run tidy -e on them.
Repeat the cleanup.

As a result, no real code, animal, or plant was harmed.
Some doc issues were eliminated.
Tidy is happy with resulting HTML; the only doclint criteria
still violated require CCC or convention changes.

If you are interested in checking doclint output, try

$JAVA_HOME/bin/java -cp $JAVA_HOME/lib/tools.jar \ 
com.sun.tools.doclint.DocLint -Xmsgs:all Whatever.java

Thanks,
-yan



More information about the swing-dev mailing list