On Fri, 25 Jun 2021 20:50:47 GMT, Brian Burkhalter <b...@openjdk.org> wrote:
>> src/java.base/share/classes/java/io/ByteArrayInputStream.java line 163:
>>
>>> 161: * @apiNote
>>> 162: * Unlike the {@link InputStream#read(byte[],int,int) equivalent
>>> method}
>>> 163: * of {@code InputStream}, this method returns {@code -1} instead
>>> of zero
>>
>> I think I would say superclass method instead of equivalent method.
>> Or prehaps overridden method.
>
> I think overridden would work best.
I think it needs to be normative text rather than an apiNote (but I'm happy
that it is now a javadoc change rather than a potentially breaking
implementation change).
-------------
PR: https://git.openjdk.java.net/jdk/pull/4591
