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
