RFR: 8307409: Refactor usage examples to use @snippet in the java.nio packages [v3]

[Alan Bateman]

On Tue, 9 May 2023 21:51:36 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

>> Convert the `<pre>{@code ...}</pre>` and some other patterns to `{@snippet ..}`.
>
> Brian Burkhalter has updated the pull request incrementally with one additional commit since the last revision:
> 
>   8307409: Fix indentation, links in snippets

src/java.base/share/classes/java/nio/X-Buffer.java.template line 2198:

> 2196:      * then the identities
> 2197:      * {@snippet lang=java :
> 2198:      *     alignmentOffset(index - value, unitSize) == 0, value ≤ index

There is html for less-than, greater-than, etc. in many of the examples that will need be changed too.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/13870#discussion_r1189421961