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

[Lance Andersen]

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 <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: jdk9-dev at openjdk.java.net
> Cc: Iris Clark; 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



Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive 
Burlington, MA 01803
Lance.Andersen at oracle.com