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

[Alan Bateman]

On Fri, 11 Nov 2022 18:56:36 GMT, Lance Andersen <lancea at openjdk.org> wrote:

>> Please review the following PR which updates several of the ZipInputStream methods whose javadoc is inherited to clarify the methods  are acting on  the current ZIP Entry.
>> 
>> There are no changes in behavior.  The main description for the method's javadoc that has been copied has been clarified and the remaining doc is the same.
>
> Lance Andersen has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Updated a javadoc for  more consistentcy

src/java.base/share/classes/java/util/zip/ZipInputStream.java line 177:

> 175:     /**
> 176:      * Returns 0 after EOF has reached for the current ZIP entry,
> 177:      * otherwise always return 1.

I think it will need to say that input stream for the current ZIP entry has been read to end of stream, or the ZIP entry has been closed with closeEntry. That will cover the two cases where it returns 0.

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

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