The javadocs of some methods in NIO Buffer are missing @since

[Glavo]

Java 9 overrides the rewind, flip and other methods of Buffer in subclasses
of Buffer such as ByteBuffer.
The methods in these subclasses do not add @since 9 to javadoc.

I think this is an oversight, because this modification destroys some code.
When compiling them with JDK 9+ and using the -target 8 option instead of
-release 8,
the generated class file crashes when running in Java 8.

IDEs cannot detect this error because there is no @since document.
Therefore, I think it is important to add @since to them, and they need to
be back ported to Java 11/17.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/core-libs-dev/attachments/20221230/30ff79bd/attachment-0001.htm>