8008662: Add @jdk.Supported to JDK-specific/supported API
Lance Andersen - Oracle
Lance.Andersen at oracle.com
Thu Feb 21 11:35:26 PST 2013
Well, that was quite a few files to have to go through :-)
Looks fine
On Feb 21, 2013, at 1:46 PM, Alan Bateman wrote:
>
> Joe Darcy recently added @jdk.Supported [1] to make it possible to identify JDK-specific APIs.
>
> I'd like to add this to a number of APIs in the com.sun namespace to make it obvious these are "supported". Specifically I'm proposing to add it to:
>
> - Java Debug Interface (com.sun.jdi)
> - Attach API (com.sun.tools.attach)
> - SCTP API (com.sun.nio.sctp)
> - HTTP server API (com.sun.net.httpserver)
> - Management extensions (com.sun.management)
> - JDK-specific API to JAAS (com.sun.security.auth)
> - JDK-specific JGSS API (com.sun.security.jgss)
>
> The javadoc for all of these is generated as part of the regular JDK "docs" build and so shouldn't be controversial. There are a number of other candidates in com.sun with murkier status that I've stayed clear of for now.
>
> The webrev with the changes is here:
>
> http://cr.openjdk.java.net/~alanb/8008662/webrev/
>
> In a couple of cases the package description is legacy package.html so I've had to move/convert them to package-info.java.
>
> In all but one case I've added the annotation to the package-info, the one exception is com.sun.management where there is at least one type that is documented as "not supported". Joe Darcy might have suggestions on that.
>
> Otherwise this is mostly mechanical and the patch file is easier to review that the webrev.
>
> -Alan
>
> [1] http://hg.openjdk.java.net/jdk8/tl/langtools/rev/55cca2f38ee6
-------------- next part --------------
A non-text attachment was scrubbed...
Name: oracle_sig_logo.gif
Type: image/gif
Size: 658 bytes
Desc: not available
Url : http://mail.openjdk.java.net/pipermail/net-dev/attachments/20130221/0095526c/oracle_sig_logo.gif
-------------- next part --------------
Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering
1 Network Drive
Burlington, MA 01803
Lance.Andersen at oracle.com
More information about the net-dev
mailing list