RFR: JDK-8319122: Improve documentation of various Zip-file related APIs [v2]

[Yakov Shafranovich]

> The various Zip/Jar-file related Java APIs have some long-standing differences or peculiarities with respect to the ZIP-file specification or compared to other implementations which should be documented in the API-doc. This documents the following:
> - Cache of JAR files in JarURLConnection class
> - Cache of JAR/ZIP files in JarFile and ZipFile classes
> - Unexpected behavior when parsing ZIP files with duplicate entries in JarFile and ZipFile classes, as well as the zipfs provider
> - Directories and filenames with the same name considered to be the same in ZipFile class
> - Possible issues when local and central headers conflict in ZipInputStream class
> 
> Related JBS report:
> https://bugs.openjdk.org/browse/JDK-8319122

Yakov Shafranovich has updated the pull request incrementally with two additional commits since the last revision:

 - Fixed more line breaks
 - fixed line breaks

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/16424/files
  - new: https://git.openjdk.org/jdk/pull/16424/files/8ee093c0..919666a0

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

  Stats: 46 lines in 5 files changed: 15 ins; 0 del; 31 mod
  Patch: https://git.openjdk.org/jdk/pull/16424.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/16424/head:pull/16424

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