RFR: 8358558: (zipfs) Reorder the listing of accessMode property in the ZIP file system's documentation

Jaikiran Pai jpai at openjdk.org
Wed Jun 4 13:19:31 UTC 2025


On Wed, 4 Jun 2025 06:47:59 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

> Can I please get a review of this trivial doc-only change to the `jdk.zipfs`'s documentation? This moves the `accessMode` property listing to the top of the table instead of being at the bottom. With this change, the text about throwing `IllegalArgumentException` when `create=true` and `accessMode=readOnly` has been moved to the `create` property's description.
> 
> No functional or specification changes are involved. I verified that the generated documentation looks fine too.

Hello Volkan, the alphabetical ordering wasn't an intention of this change. But after what you noted, I was almost considering making it alphabetically ordered, but then I noticed that I will also have to move down the properties `encoding` and `enablePosixFileAttributes`. So I think it's not worth it.

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

PR Comment: https://git.openjdk.org/jdk/pull/25634#issuecomment-2939124076


More information about the core-libs-dev mailing list