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

[Alan Bateman]

On Mon, 14 Nov 2022 18:16:50 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:
> 
>   Additional wordsmithing on available()

Marked as reviewed by alanb (Reviewer).

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

> 176:      * Returns 0 when end of stream is detected for the current ZIP entry or
> 177:      * {@link #closeEntry()} has been called on the current ZIP entry, otherwise always return 1.
> 178:      * <p>

The updated wording looks okay. One small thing is that I think it would be a bit better if the word "always" were dropped.

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

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