RFR: JDK-8262435: Clarify the behavior of a few inherited ZipInputStream methods [v2]

[Lance Andersen]

On Fri, 11 Nov 2022 17:46:08 GMT, Alan Bateman <alanb at openjdk.org> wrote:

> I think it would be useful to generate the javadoc and see if there are terminology or wording differences between the existing and new descriptions being copied down from input stream.
> 
> For example, the no-arg read is "Reads a byte of uncompressed data from the input stream for the current ZIP entry" where the 3-arg read is "Reads from the current ZIP entry into an array of bytes, returning the number of inflated bytes". So one speaks of reading from the input stream, the other of reading from the current the ZIP entry. One speaks of reading uncompressed data, the other is returning inflated bytes. Another example is the skip methods. The no-arg skip speaks of skipping bytes in the current ZIP entry. The skipNBytes speaks of skipping and discard bytes of data from the input stream. The available method might need attention too because it it specified a result for when EOF for the current entry data is reached.

Thanks for the suggestion.  I made another pass to make the phrasing more consistent

-------------

PR: https://git.openjdk.org/jdk/pull/10995