<br><br><div class="gmail_quote">On Thu, Feb 21, 2013 at 6:16 PM, Joe Darcy <span dir="ltr"><<a href="mailto:joe.darcy@oracle.com" target="_blank">joe.darcy@oracle.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="im"><br></div>
However, the com.sun.* subpackages are a mix of APIs that are supported as described above as well as APIs that are not supported.</blockquote><div><br></div><div>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.* .</div>
<div><br></div><div>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?</div>
</div>