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

[Iris Clark]

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.

 

Regards,

iris

 

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.

 

Best

Lance

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





oops.

The webrev link should be:

http://cr.openjdk.java.net/~iris/verona/8136494/webrev.0/

Regards,
iris

-----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

Hi.

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.

Bug

 8136494 Update "@since 1.9" to "@since 9" to match 
   java.version.specification
 https://bugs.openjdk.java.net/browse/JDK-8136494

Webrev

 http://cr.openjdk.java.net/~iris/verona/8136594/webrev.0/

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`.

Thanks,
iris

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

 

http://oracle.com/us/design/oracle-email-sig-198324.gif

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