8008662: Add @jdk.Supported to JDK-specific/supported API
mandy.chung at oracle.com
Fri Feb 22 01:43:03 UTC 2013
On 2/21/2013 10:46 AM, Alan Bateman wrote:
> Joe Darcy recently added @jdk.Supported  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".
It's nice to be able to mark what is supported vs unsupported in the
com.sun namespace since there are a mix of supported and unsupported APIs.
> The webrev with the changes is here:
Looks good to me.
> 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.
I wasn't aware of the unsupported com.sun.management.OSMBeanFactory
class being included in the javadoc. I think that can be fixed and I'll
file a bug and hopefully we can clean that up.
> Otherwise this is mostly mechanical and the patch file is easier to
> review that the webrev.
>  http://hg.openjdk.java.net/jdk8/tl/langtools/rev/55cca2f38ee6
More information about the core-libs-dev