8000269: Cleanup javadoc warnings
joe.darcy at oracle.com
Sat Sep 29 21:07:19 UTC 2012
The whole patch looks good Alan; approved,
On 9/29/2012 1:52 PM, Alan Bateman wrote:
> 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 , 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 releases.
> 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