RFR: 4842457: (bf spec) Clarify meaning of "(optional operation)" [v2]

Brian Burkhalter bpb at openjdk.org
Tue Mar 21 19:30:33 UTC 2023


On Tue, 21 Mar 2023 19:16:44 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

>> src/java.base/share/classes/java/nio/X-Buffer.java.template line 269:
>> 
>>> 267:  * however, instead throw an {@linkplain UnsupportedOperationException} if the
>>> 268:  * $Type$Buffer is not backed by an {@linkplain Buffer#hasArray accessible
>>> 269:  * $type$ array} irrespective of whether the $Type$Buffer is read-only.
>> 
>> This mostly looks okay but I think it would be clearer to drop "however, instead"  and put "irrespective ..." in parentheses.
>
> I thought "however, instead" a bit clunky as well; will update.

Refined in 12e5fe15237a5f5cebbaf2ed4e81a851074e3e5c.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/13123#discussion_r1143895168


More information about the nio-dev mailing list