RFR: 8049109: Add @since 1.9 to new packages added in jaxp (original) (raw)

Henry Jen henry.jen at oracle.com
Thu Jul 3 01:02:13 UTC 2014

I don't have a strong preference in this case, and I hear you that those classes are public and can be accessed in 1.5 even though it's not part of API specification of JDK.

Considered DOM Level 2 is still listed as secondary information, and as the document you pointed out, 1.9 is used because that those APIs will become official in JDK 9.

Lets give it a couple days before commit this, hopefuly some dicussion(along with other cases brought up in this thread[1]) will occur and lead to a concensus. Sometime I feel we need a supreme court for Java affairs to come out the final ruling on such stuff. :)

[1] http://mail.openjdk.java.net/pipermail/core-libs-dev/2014-July/027503.html

Cheers, Henry

On 07/02/2014 05:12 PM, huizhe wang wrote:

These packages were defined in JDK 1.5 / JAXP 1.3 (JSR 206). In that sense, they were in JDK since 1.5.

For reasons I don't know, they were excluded from the Java API Documentation. From the tag conventions <http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#@since> [1], you may be right since it "Specify the product version when the Java name was added to the API specification". But it can be confusing to users since they've been using them since JDK 1.5 [1] http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#@since -Joe On 7/2/2014 3:43 PM, Joe Darcy wrote: Looks good Henry; cheers,

-Joe On 07/02/2014 02:45 PM, Henry Jen wrote: Hi,

Related to JDK-8023276[1] where we added two packages to JDK 9, we should update @since to have 1.9 value as well. http://cr.openjdk.java.net/~henryjen/jdk9/8049109/0/webrev/ [1] https://bugs.openjdk.java.net/browse/JDK-8023276 Cheers, Henry

More information about the core-libs-dev mailing list