JDK-8144069 : Determine correct publication for jdk.Version API
  • Type: Bug
  • Component: other-libs
  • Sub-Component: other
  • Affected Version: 9
  • Priority: P4
  • Status: Resolved
  • Resolution: Not an Issue
  • Submitted: 2015-11-25
  • Updated: 2016-03-16
  • Resolved: 2016-03-16
Related Reports
Relates :  
JDK-8145793 - Provide vendor-specific interpretation of a JDK version string
Relates :  
JDK-8061493 - JEP 223: New Version-String Scheme
Relates :  
JDK-8144062 - Move jdk.Version to java.lang.Runtime.Version
Relates :  
JDK-8072379 - CoreLibs: Implement jdk.Version
Description
jdk.Version and jdk.OracleVersion were added for Verona (JEP 223). At present they are both incorrectly included in the javac tree API along with jdk.Exported.   They were automatically included in this bundle due to their proximity to jdk.Exported in the source.

JDK-specific documentation is currently accessed via a link in the diagram on this page,  http://docs.oracle.com/javase/8/docs/  , however that may be changed for JDK 9.

For the javadoc generation:  The jdk package is listed in <top>/make/common/NON_CORE_PKGS.gmk but there is no target in make/Javadoc.gmk to build it.
Comments
In JDK-8144062, jdk.Version will be relocated to java.lang.Runtime.Version (a nested class of Runtime). The javadoc for Version will be included in the familiar Java SE javadoc bundle which contains specification for other classes in java.lang.
16-03-2016
During review, it was determined that jdk.OracleVersion was not needed at this time. JDK-8145793 has been filed to track the request.
13-01-2016