On Fri, 11 Nov 2022 17:46:08 GMT, Alan Bateman <al...@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
