RFR: 8278165: Clarify that ZipInputStream does not access the CEN fields for a ZipEntry [v3]

[Lance Andersen]

> Hi,
> 
> Please review this update to the ZipInputStream class description to clarify that ZipInputStream walks sequentially through each Zip Entry contained within the Zip File.  As a result, the CEN header for the Zip file entries are not read resulting in ZipInputStream not having access to information that is stored within the CEN Header fields such the as the external file attributes which can be used to store optional data such as Posix Permissions.

Lance Andersen has updated the pull request incrementally with one additional commit since the last revision:

  Converted example to be a snippet

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/10102/files
  - new: https://git.openjdk.org/jdk/pull/10102/files/fe462d7f..ea3510b9

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=10102&range=02
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=10102&range=01-02

  Stats: 3 lines in 1 file changed: 0 ins; 2 del; 1 mod
  Patch: https://git.openjdk.org/jdk/pull/10102.diff
  Fetch: git fetch https://git.openjdk.org/jdk pull/10102/head:pull/10102

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