8251160: Fix "no comment" warnings in java.logging

Daniel Fuchs daniel.fuchs at oracle.com
Fri Aug 14 09:17:08 UTC 2020


Hi Mandy,

Thanks for looking at this!

On 13/08/2020 20:48, Mandy Chung wrote:
> Level
> 
> The javadoc for readResolve seems internal implementation details. Would 
> it be sufficient to say:
> 
> “Returns a {@code Level} instance with the same {@code name},
>   {@code value}, and {@code resourceBundleName} as the deserialized
>   object"

Good idea! Done.

> LogRecord
> 
> + * See {@code writeObject} for a description of the serial form.
> 
> This can use @see instead.

Unfortunately not - I tried it.

Links towards the Serialized Form page are not working.
In this case (@see) neither the text of the link nor the link
is generated by the javadoc.

new webrev:
http://cr.openjdk.java.net/~dfuchs/webrev_8251160/webrev.01/index.html

CSR updated as well:
https://bugs.openjdk.java.net/browse/JDK-8251534

best regards,

-- daniel

> 
> Mandy




More information about the core-libs-dev mailing list