On Tue, 26 May 2026 14:37:58 GMT, Volker Simonis <[email protected]> wrote:
>> Fixed. > > I'm not sure if it is the right thing to **mandate** a knowingly wrong > implementation in the API doc which is what we effectively do in the current > form. From my point of view, the only acceptable tag for such a sentence > would be `@implNote` because it described implementation details which "*are > allowed to vary across platforms, vendors, and versions*" (although this is > unlikely nowadays where we more or less only have a single JDK > implementation). @simonis It's okay to specify that it invokes the underlying stream's available method. It is possible that you are reading this to mean that it interprets 0 as EOF? That is not the intention. As per the discussion in JBS, the general plan is re-visit the issue of how readTrailer behaves once GZIPInputStream behavior is restored (already done), and once its specification is updated to document long standing behavior. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/30925#discussion_r3304967667
