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

Stuart Marks stuart.marks at oracle.com
Tue May 10 23:21:15 UTC 2016


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")

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.

s'marks



More information about the core-libs-dev mailing list