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

2024-01-09 Thread Yakov Shafranovich
On Mon, 13 Nov 2023 18:11:12 GMT, Alan Bateman 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 th

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

2024-01-09 Thread Yakov Shafranovich
On Wed, 22 Nov 2023 22:23:18 GMT, Yakov Shafranovich wrote: >> src/java.base/share/classes/java/util/zip/ZipInputStream.java line 77: >> >>> 75: * >>> 76: * Whenever possible, {@linkplain ZipFile} should be used for parsing >>> ZIP >>> 77: *

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

2024-01-09 Thread Yakov Shafranovich
he 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 with a new target base due to a merge or

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

2024-01-02 Thread Yakov Shafranovich
On Fri, 10 Nov 2023 15:44:19 GMT, Yakov Shafranovich wrote: >> 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 documen

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

2023-11-22 Thread Yakov Shafranovich
On Tue, 14 Nov 2023 12:21:42 GMT, Alan Bateman wrote: >> Yakov Shafranovich has updated the pull request incrementally with two >> additional commits since the last revision: >> >> - Fixed more line breaks >> - fixed line breaks > > src/j

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

2023-11-13 Thread Yakov Shafranovich
On Sat, 11 Nov 2023 14:04:11 GMT, Alan Bateman wrote: >> Yakov Shafranovich has updated the pull request incrementally with two >> additional commits since the last revision: >> >> - Fixed more line breaks >> - fixed line breaks > > src/jdk.zipfs/sha

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

2023-11-10 Thread Yakov Shafranovich
he 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

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

2023-11-10 Thread Yakov Shafranovich
On Thu, 9 Nov 2023 20:43:25 GMT, Kevin Driver wrote: >> Yakov Shafranovich has updated the pull request incrementally with two >> additional commits since the last revision: >> >> - Fixed more line breaks >> - fixed line breaks > > src/jdk.zipfs/sha

Re: RFR: JDK-8319122: Improve documentation of various Zip-file related APIs

2023-11-10 Thread Yakov Shafranovich
On Thu, 9 Nov 2023 20:42:52 GMT, Kevin Driver wrote: >> 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 docum

Re: RFR: JDK-8319122: Improve documentation of various Zip-file related APIs

2023-11-10 Thread Yakov Shafranovich
On Thu, 9 Nov 2023 20:41:22 GMT, Kevin Driver wrote: >> 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 docum

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

2023-11-03 Thread 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