RFR: 8136494 Update "@since 1.9" to "@since 9" to match java.specification.version

Iris Clark iris.clark at oracle.com
Thu Jan 7 17:06:20 UTC 2016

Hi, Lance.


Thanks for the review.


I was a bit puzzled by the code you quoted back since it relates to the recent move of VM class, which I didn't touch.   It appears that my forest was not sufficiently up-to-date with respect to dev when I did the webrev.  The build I launched after I sent out the RFR failed. 


I'll fix the forest/webrev later today.





From: Lance Andersen 
Sent: Thursday, January 07, 2016 4:35 AM
To: Iris Clark
Cc: jdk9-dev at openjdk.java.net; verona-dev at openjdk.java.net
Subject: Re: RFR: 8136494 Update "@since 1.9" to "@since 9" to match java.specification.version


Hi Iris,


I think the changes are OK.  I would suggest  making your description clear for your changes such as:



@@ -1019,7 +1019,7 @@
      * may be controlled by the {@code -XX:AutoBoxCacheMax=<size>} option.
      * During VM initialization, java.lang.Integer.IntegerCache.high property
      * may be set and saved in the private system properties in the
-     * jdk.internal.misc.VM class.
+     * sun.misc.VM class.




for your push.




On Jan 6, 2016, at 11:33 PM, Iris Clark <HYPERLINK "mailto:iris.clark at oracle.com"iris.clark at oracle.com> wrote:


The webrev link should be:



-----Original Message-----
From: Iris Clark 
Sent: Wednesday, January 06, 2016 8:30 PM
To: HYPERLINK "mailto:jdk9-dev at openjdk.java.net"jdk9-dev at openjdk.java.net
Cc: Iris Clark; HYPERLINK "mailto:verona-dev at openjdk.java.net"verona-dev at openjdk.java.net
Subject: RFR: 8136494 Update "@since 1.9" to "@since 9" to match java.specification.version


In Verona (JEP 223: New Version-String Scheme[0]), the system property java.specification.version was updated from "1.9" to "9".
@since tags for new JDK 9 APIs should be aligned with the new value.

Please review the following changes to the jaxp, jaxws, jdk, langtools, and nashorn repositories.  As usual with such changes, the patch file is the most helpful view of the changeset.


 8136494 Update "@since 1.9" to "@since 9" to match 



In addition to the changeset, I will update JEP 223 as follows:

   @since JavaDoc tag

   The value for the @since JavaDoc tag will continue to be 
   aligned with the system property `java.specification.version`; 
   hence, new JDK 9 APIs will be indicated by `@since 9`.


[0] http://openjdk.java.net/jeps/223



HYPERLINK "http://oracle.com/us/design/oracle-email-sig-198324.gif"
Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive 
Burlington, MA 01803
HYPERLINK "mailto:Lance.Andersen at oracle.com"Lance.Andersen at oracle.com



More information about the verona-dev mailing list