On 4/06/2014 1:38 PM, Paul Benedict wrote:
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?
The "naming documents" eg:
http://www.oracle.com/technetwork/java/javase/jdk7-naming-418744.html
indicate using the version string on @since tags ie 1.7, 1.8
David
Cheers,
Paul
On Tue, Jun 3, 2014 at 10:17 PM, Mike Duigou <mike.dui...@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....@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
