RFR: 8049109: Add @since 1.9 to new packages added in jaxp
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) 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. :)
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
> , 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
> On 7/2/2014 3:43 PM, Joe Darcy wrote:
>> Looks good Henry; cheers,
>> On 07/02/2014 02:45 PM, Henry Jen wrote:
>>> Related to JDK-8023276 where we added two packages to JDK 9, we
>>> should update @since to have 1.9 value as well.
>>>  https://bugs.openjdk.java.net/browse/JDK-8023276
More information about the core-libs-dev