RFR: 8029451 : Tidy warnings cleanup for java.util package

[Joe Darcy]

On 12/06/2013 09:20 AM, Martin Buchholz wrote:
> FYI: When I run javadoc on jsr166 CVS (it's not too hard for y'all to do
> this as well), I still see many warnings inherited from openjdk8 source:
>
>   $ ant docs
> ...
>    [javadoc] Constructing Javadoc information...
>    [javadoc] Standard Doclet version 1.8.0-ea
>    [javadoc] Building tree for all the packages and classes...
>    [javadoc]
> /home/martin/jdk/src/jdk8/jdk/src/share/classes/java/util/ArrayList.java:759:
> warning: no @param for s
>    [javadoc]     private void readObject(java.io.ObjectInputStream s)
>    [javadoc]                  ^
>    [javadoc]

We have been working to address doclint issues against public and 
protected elements, which is not to say readObject and writeObject 
methods shouldn't have javadoc.

-Joe