On Thu, 30 Apr 2026 13:30:01 GMT, Jaikiran Pai <[email protected]> wrote:
>
> If there's a better way to word it and place it as class level doc, then let
> me know and I'll give it a try.
Perhaps something like the following might work:
++++++++++++++++++++
When processing a GZIP stream, this class may read ahead in the underlying
stream while completing a member or determining whether another member follows.
Consequently, an unspecified number of bytes beyond a member’s trailer may be
consumed.
If the bytes read ahead do not constitute a valid header for a subsequent
member, the stream is considered to have reached end-of-stream, and further
reads return {@code -1}.
For concatenated GZIP streams, each invocation of {@link #read(byte[], int,
int)} yields decompressed data from at most one member; data from multiple
members is not combined in a single read operation.
++++++++++++++++++++
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/30925#discussion_r3184280829
