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

Reply via email to