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