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

[Alan Bateman]

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

> Add some clarifying verbiage about optional operations to the type-specific buffer classes.

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.

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

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