On Tue, 4 Jun 2024 16:24:23 GMT, Alexey Ivanov <aiva...@openjdk.org> wrote:
>> Nizar Benalla has updated the pull request incrementally with one additional
>> commit since the last revision:
>>
>> Swing was added in JDK 1.2
>
> src/java.desktop/share/classes/java/awt/geom/Path2D.java line 297:
>
>> 295: /**
>> 296: * @since 10
>> 297: */
>
> Not sure it's required…
>
> If it is, you should also add explicit `{@inheritDoc}`:
>
> Suggestion:
>
> /**
> * {@inheritDoc}
> *
> * @since 10
> */
1. You don't _need_ an explicit `{@inheritDoc}` although you may choose to do
so for explicit clarity.
2. `@since` can be omitted for a member if the value would be the same as on
the enclosing class
3. When present, `@since` on a method should indicate the first release in
which the method is available for use on that class, with that VM signature
(includes args and return type)
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/19192#discussion_r1635368076
