On Mon, 17 Apr 2023 14:23:01 GMT, Pavel Rappo <[email protected]> wrote:
>> olivergillespie has updated the pull request incrementally with one
>> additional commit since the last revision:
>>
>> Fix two typos
>
> src/java.base/share/classes/java/lang/Enum.java line 177:
>
>> 175: * HotSpot's identity hash code generation also never returns zero
>> 176: * as the identity hash code. This makes zero a convenient marker
>> 177: * for the un-initialized value for both {@link @Stable} and the
>> lazy
>
> I'm sorry, but `@Stable` won't work with `@link`. `@Stable` is not a class,
> interface, member name, etc. See
> https://docs.oracle.com/en/java/javase/20/docs/specs/javadoc/doc-comment-spec.html#references
The @implNote is more appropriate for an internal comment. It is not needed to
be in the published javadoc; its only useful to someone viewing the source code.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/13491#discussion_r1168852243
