Bug ID: JDK-8204565 (spec) Document java.{vm.}?specification.version system properties' relation to $FEATURE

JDK-8204565 : (spec) Document java.{vm.}?specification.version system properties' relation to $FEATURE

Type: Enhancement
Component: core-libs
Sub-Component: java.lang

Priority: P4
Status: Resolved
Resolution: Fixed

Submitted: 2018-06-07
Updated: 2018-11-29
Resolved: 2018-06-12

Versions (Unresolved/Resolved/Fixed)

The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.

JDK 11
11 b18Fixed

Related Reports

CSR :	JDK-8203640 - (spec) Document java.{vm.}?specification.version system properties' relation to $FEATURE
Duplicate :	JDK-8162686 - (spec) java.{vm.}?specification is independent of java.version
Relates :	JDK-8162686 - (spec) java.{vm.}?specification is independent of java.version
Relates :	JDK-8162687 - java.{vm.}?specification.version is always set to the Java major version
Relates :	JDK-8162687 - java.{vm.}?specification.version is always set to the Java major version

Description

With the integration of JEP 322 "Time-Based Release Versioning" 
into JDK 10, VERSION_FEATURE is used to set the value of the system properties "java.specification.version" [1] and "java.vm.specification.version" [2] (though the term "major" is still used in VM code, see JDK-8193719).

We can update the System.getProperties() javadoc to be more specific about the value reported in these system properties.

1. http://hg.openjdk.java.net/jdk/jdk/rev/d2a837cf9ff1#l6.23
2. http://hg.openjdk.java.net/jdk/jdk/rev/d2a837cf9ff1#l15.17