Re: RFR: 8215788: Clarify JarInputStream Manifest access [v6]

2022-09-20 Thread Lance Andersen
On Mon, 19 Sep 2022 20:30:48 GMT, Weijun Wang wrote: > Does this mean that the "Verifying a JarInputStream" should also avoid > mentioning "getManifest method returns the manifest"? I understand precisely > it should be "getManifest method is able to return the manifest if you call > it". See

Re: RFR: 8215788: Clarify JarInputStream Manifest access [v6]

2022-09-19 Thread Weijun Wang
On Mon, 19 Sep 2022 17:53:51 GMT, Lance Andersen wrote: >>> I can remove, but I am not sure I agree we need to describe main vs >>> attribute here given we are pointing to the Jar spec and if there is any >>> discussion of Pre-entry attributes, it should be in JarEntry IMHO. I guess >>> the cl

Re: RFR: 8215788: Clarify JarInputStream Manifest access [v6]

2022-09-19 Thread Lance Andersen
On Mon, 19 Sep 2022 06:34:00 GMT, Alan Bateman wrote: > > I can remove, but I am not sure I agree we need to describe main vs > > attribute here given we are pointing to the Jar spec and if there is any > > discussion of Pre-entry attributes, it should be in JarEntry IMHO. I guess > > the clar

Re: RFR: 8215788: Clarify JarInputStream Manifest access [v6]

2022-09-18 Thread Alan Bateman
On Sun, 18 Sep 2022 20:33:55 GMT, Lance Andersen wrote: > I can remove, but I am not sure I agree we need to describe main vs attribute > here given we are pointing to the Jar spec and if there is any discussion of > Pre-entry attributes, it should be in JarEntry IMHO. I guess the > clarificat

Re: RFR: 8215788: Clarify JarInputStream Manifest access [v6]

2022-09-18 Thread Lance Andersen
On Sun, 18 Sep 2022 19:49:51 GMT, Alan Bateman wrote: >> Lance Andersen has updated the pull request incrementally with one >> additional commit since the last revision: >> >> Incorporated latest round of input > > src/java.base/share/classes/java/util/jar/JarInputStream.java line 36: > >> 3

Re: RFR: 8215788: Clarify JarInputStream Manifest access [v6]

2022-09-18 Thread Alan Bateman
On Sat, 17 Sep 2022 14:35:46 GMT, Lance Andersen wrote: >> Please review this PR which updates the JarInputStream class description to >> clarify when the Manifest is accessible via JarInputStream::getManifest and >> JarInputStream::get[Jar]Entry. >> >> It is worth noting that with this updat

Re: RFR: 8215788: Clarify JarInputStream Manifest access [v6]

2022-09-17 Thread Lance Andersen
> Please review this PR which updates the JarInputStream class description to > clarify when the Manifest is accessible via JarInputStream::getManifest and > JarInputStream::get[Jar]Entry. > > It is worth noting that with this update, we are finally documenting > behavior that dates back to w