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

[Yuri Nesterenko]

One more time! Please take a look.

Mailing list is a lousy tool for review requests like this.

Thanks,
-yan

On 12/02/2013 06:07 PM, Yuri Nesterenko wrote:
> 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