On Thu, 22 Feb 2024 14:06:25 GMT, Eirik Bjørsnøs <eir...@openjdk.org> wrote:
> Alan,
>
> Finding a good way to express this while being correct and succinct was
> surprisingly hard. What I have now is probably far from perfect, but at least
> something to serve as a starting point for review:
The `@depreacted` text looks fine.
For the class description then it might be simpler to reduce the new text down
to one sentence, e.g. "This method returns the equivalent of {@code (int)
getBytesRead()} and therefore cannot return the correct number of compressed
bytes input so far when it is greater than Integer.MAX_VALUE."
-------------
PR Comment: https://git.openjdk.org/jdk/pull/17919#issuecomment-1962972560
