8008662: Add @jdk.Supported to JDK-specific/supported API

[Martin Buchholz]

On Thu, Feb 21, 2013 at 6:16 PM, Joe Darcy <joe.darcy at oracle.com> wrote:

>
> However, the com.sun.* subpackages are a mix of APIs that are supported as
> described above as well as APIs that are not supported.


I was under the impression that the general rule was that all of com.sun.*
fell under the "jdk supported" umbrella, and the level of support was the
distinction between sun.com.* and sun.* .

In any case, it would be good if there was a single canonical place that
documented the various levels of support with subtle distinctions,
including java.* vs. javax.*, endorsed standards, com.sun.* vs. sun.* vs.
jdk.*, and recommendations for where non-Oracle vendor extensions should
go.  Is the jdk.Supported annotation itself part of Java SE?  Should
third-party vendor extensions that are "supported" for public use by the
third-party use jdk.Supported?  What about the X's in hotspot flags and the
java tools command line interfaces?