RFR (JAXP) 8152912: SAX XMLReaderFactory needs to be ServiceLoader compliant

huizhe wang huizhe.wang at oracle.com
Wed May 11 07:20:04 UTC 2016


On 5/10/2016 4:21 PM, Stuart Marks wrote:
> On 5/9/16 2:59 PM, huizhe wang wrote:
>>> This looks much better to me.
>>> I just wonder about the @Deprecated("5") vs @Deprecated("1.5")
>>
>> Yes, the compiler accepted it just fine and produced javadocs similar 
>> to that of
>> XMLReaderFactory where since="9".
>
> Hi Joe, Daniel,
>
> The namespace of the @Deprecated 'since' element is the same as the 
> @since javadoc tag. APIs that were added in Java 5 have "@since 1.5" 
> in their javadoc, so something that was deprecated in Java 5 should be 
> annotated
>
>     @Deprecated(since="1.5")

Make sense (to be consistent with that of javadocs). I'll use the next 
opportunity to get these fixed.

>
> It looks like we didn't go to single-digit versions until Java 9. 
> Earlier versions are still listed as 1.8, 1.7, 1.6, 1.5, and so forth.

Interestingly the Java SE Naming and Versions [1] indicated that 5.0, 6, 
7, 8 are "product versions", while 1.x are "developer" versions.

[1] http://www.oracle.com/technetwork/java/javase/namechange-140185.html

-Joe

>
> s'marks




More information about the core-libs-dev mailing list