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

Paul Benedict pbenedict at apache.org
Wed Jun 4 03:38:54 UTC 2014

I like seeing "JDK" as well... primarily because IDEs have the ability to show javadoc snippets when hovering over an element. It's good to see what product the version comes relates to.

Yet, on the other hand, these Oracle APIs are not published under "JDK" branding but under the title "Java SE". Shouldn't that be used instead?

Cheers, Paul

On Tue, Jun 3, 2014 at 10:17 PM, Mike Duigou <mike.duigou at oracle.com> wrote:

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