On Wed, 31 Jan 2024 14:52:58 GMT, Maurizio Cimadamore <mcimadam...@openjdk.org>
wrote:
>> src/java.base/share/classes/java/lang/foreign/Arena.java line 261:
>>
>>> 259:
>>> 260: /**
>>> 261: * {@return a new shared arena} Segments allocated with the shared
>>> arena can be
>>
>> Suggestion:
>>
>> * {@return a new shared arena} Segments allocated with a shared arena
>> can be
>
> There is a similar issue in the javadoc of `ofConfined`, which also uses
> `the` instead of `a`.
Also, I have noted that the javadoc of `ofAuto` uses a different style -
instead of saying "segments allocated with an automatic arena", it says
"segments allocated with the returned arena" (in more places). So perhaps we
should make these more consistent?
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/17653#discussion_r1472944597
