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

[Paul Benedict]

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