RFR 8251203: Fix "no comment" warnings in java.base/java.lang and java/io
Daniel Fuchs
daniel.fuchs at oracle.com
Fri Aug 21 17:32:49 UTC 2020
Hi Roger,
On 21/08/2020 17:52, Roger Riggs wrote:
> The @serial javadoc tag is used on any serialization related field or
> method.
> Are there some missing? I expect javac would warn if they were missing.
Well I was wondering whether an @serial tag would be appropriate in
the documentation of these fields, for instance:
http://cr.openjdk.java.net/~rriggs/webrev-nocomment-8251203-2/src/java.base/share/classes/java/lang/StackTraceElement.java.frames.html
The only purpose of documenting these fields is for the
SerializedForm, isn't it?
best regards,
-- daniel
More information about the core-libs-dev
mailing list