RFR: 8303923: ZipOutStream::putEntry should include an apiNote to indicate that the STORED compression method should be used when writing directory entries [v2]

[Eirik Bjorsnos]

> ZipOutputStream currently writes directory entries using the DEFLATED compression method. This does not strictly comply with the APPNOTE.TXT specification and is also about 10x slower than using the STORED compression method.
> 
> Because of these concerns, `ZipOutputStream.putNextEntry` should be updated with an `@apiNote` recommending
> the use of the STORED compression method for directory entries.
> 
> Suggested CSR in the first comment.

Eirik Bjorsnos has updated the pull request incrementally with two additional commits since the last revision:

 - Make snippet syntactically valid
 - Update copyright year

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/12899/files
  - new: https://git.openjdk.org/jdk/pull/12899/files/f57735cf..864a0887

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

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

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