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

[Alan Bateman]

On Mon, 13 Nov 2023 16:00:05 GMT, Yakov Shafranovich <duke at openjdk.org> wrote:

> That would probably also involve taking existing documentation such as the note about not opening entries with "."/"..", and the POSIX permissions mappings? Would it make sense to split the rest of the changes in this PR from the zipfs changes since that's going to be a bigger undertaking?

Yes, I think it should be separated, and it would be nice to drop the changes to jdk.zipfs from this PR. If/when this documentation is written then it describe the "/" character and the synthesized links that are "." and "..", which can lead to documentation that a zip file that contain contains with  "." or ".." elements cannot be opened as a file system.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/16424#discussion_r1391493510