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

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.

Mike

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