RFR: 8044740: Convert all JDK versions used in @since tag to 1.n[.n] in jdk repo

Henry Jen henry.jen at oracle.com
Wed Jun 4 01:22:00 UTC 2014


Hi,

In an effort to determine APIs availability in a given version, it 
became obvious that a consistent way to express @since tag would be 
beneficial.

So started with the most obvious ones, where we have various expression 
for JDK version, this webrev make sure we use @since 1.n[.n] for JDK 
versions.

The main focus is on public APIs, private ones are taken care if it is 
straightforward, otherwise, we try to keep the information.

Some public APIs are using @since <STANDARD> <standard version> format, 
they are also preserved for now, but I think it worth discussion whether 
we want to change to the version as included in J2SE.

There are APIs without @since information, separate webrevs will be 
coming to complete those information.

Bug: https://bugs.openjdk.java.net/browse/JDK-8044740
The webrev can be found at
http://cr.openjdk.java.net/~henryjen/jdk9/8044740/0/webrev

but it's probably easier just look into the raw diff,
http://cr.openjdk.java.net/~henryjen/jdk9/8044740/0/webrev/jdk.changeset

Cheers,
Henry



More information about the core-libs-dev mailing list