8000269: Cleanup javadoc warnings

Alan Bateman Alan.Bateman at oracle.com
Sat Sep 29 20:52:12 UTC 2012

A small number of javadoc warnings have sneaked into the jdk8 builds 
lately. They are easily fixed but it's a good opportunity to try out 
Jon's doccheck tool [1], built on the DocTree API, and get a better 
workout. I decided to mostly focus on -Xmsgs:reference, which covers 
references like @param and @throws. I fixed a small number of html 
issues along the way but that was not my focus. The webrev, which fixes 
up most of the reference issues in roughly the core area, is here:


When I say "most" then I excluded j.u.c and java.lang.invoke.

The reason that so many files are changed is because doccheck looks at 
private and package-private classes and methods that wouldn't normally 
be in the javadoc. Also, no foray into the *Permission classes is 
possible without fixing up at least a few formatting issues. Note that 
there is one non-javadoc change in this webrev; in java.net.Inet4Address 
I have removed a private static field that has not been used for several 

The changes are trivial and easy to review. At it covers many areas then 
partial reviews are okay too.




More information about the core-libs-dev mailing list