On Mon, 26 Feb 2024 19:55:47 GMT, Lance Andersen <lan...@openjdk.org> wrote:

> This PR updates the javadoc and comments within java.util.zip/jar and zipfs 
> module summary so that it is consistent with the use of "ZIP".
> 
> In addition, open/src/java.base/share/classes/java/util/zip/package-info.java 
> has been updated to point to the higher level location of the PKWARE 
> APPNOTE.TXT has PKWare recently changed the direct path the the latest 
> version of the spec.
> 
> It is also worth noting that error messages were not updated as part of the 
> PR and will be updated separately to keep the javadoc changes separate

The class javadocs for `java.util.zip.ZipCoder` uses "zipfile" which is 
probably a reference to the `ZipFile` class.

`jdk.nio.zipfs.ZipCoder` seems to have borrowed the class javadocs, but here 
`ZipFile` does not make sense. Perhaps `ZipFileSystem` would be better?

Would you consider fixing this to CamelCase in this PR (although it is maybe 
not directly the same inconsistency the PR aims to fix)?
 
https://github.com/openjdk/jdk/blob/c5c866aafe76f51cd5386bf5052c06691c1a0e8c/src/java.base/share/classes/java/util/zip/ZipCoder.java#L41

https://github.com/openjdk/jdk/blob/c5c866aafe76f51cd5386bf5052c06691c1a0e8c/src/jdk.zipfs/share/classes/jdk/nio/zipfs/ZipCoder.java#L41

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

PR Comment: https://git.openjdk.org/jdk/pull/18011#issuecomment-1966701666

Reply via email to