RFR: 8231093: Document the ZIP FS properties noCompression and releaseVersion

[Martin Buchholz]

On Fri, Sep 20, 2019 at 9:02 AM Alan Bateman <Alan.Bateman at oracle.com>
wrote:

> On 20/09/2019 16:54, Martin Buchholz wrote:
> > Thanks.
> >
> > When we document these properties, we should make it clearer what the
> > default behavior is, e.g. what happens if a multi-release jar is used
> > and releaseVersion is unspecified.
> The table of properties that we've started to build up in the JDK 14
> builds has a column for the default value so hopefully the defaults will
> be clear.


Right - I missed that.  I read
https://download.java.net/java/early_access/jdk14/docs/api/jdk.zipfs/module-summary.html
and I now see I also confused "system properties" with "file system
properties"


> Also the description for "releaseVersion" has proposed text to
> say that the JAR file will be considered unversioned when the property
> is not specified, maybe you are saying that wording needed to be improved?
>

I re-read the proposed spec for releaseVersion, and I don't see where it
says that.  A very pedantic reading is that the default value is null,
which does not represent  a valid version number, so the default behavior
should be to throw IllegalArgumentException ?!

>
>
> I agree the noCompression property should be examined to allow for other
> potential compression methods.
>
> -Alan
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/nio-dev/attachments/20190920/3954b8ce/attachment.html>