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

Mike Duigou mike.duigou at oracle.com
Wed Jun 4 03:17:10 UTC 2014

You will need to include awt-dev and security-dev since this patch touches those areas as well. Other impacted groups I missed?

I would like to see this all go back in one changeset to dev repo though as it would be a lot cleaner that way.

I am concerned a bit that if we retain standard names for non-jdk standards it may be sometimes confusing or lacking in context to see a raw version number. Consistency is trumps all, but I would prefer to see JDK#.#[.#] used to be unambiguous.

I don't see any missteps in the changeset but wouldn't want mine to be the only review.


On Jun 3 2014, at 18:22 , Henry Jen <henry.jen at oracle.com> wrote:

> 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