Adding @since tags
richard.bair at oracle.com
Tue May 28 10:24:17 PDT 2013
>> Another question, when a class is added in a release, do you add @since to the class but *not* the methods, or do you tag both the class and the methods? It seems more foolproof to tag both the class & methods, but I don't think that is how they do it on the JDK side.
> I add it only to the class. Indeed, this is the JDK practice. SigTest reports new class as a single change, so right now I don't have input for adding it everywhere. I think I could go over the new classes, add empty classes with the same names to the old jar and then use the tool to generate the tags for the API difference which will now be all the contents of the classes. Do you think it's worth the effort?
Nope, doing it the JDK way is fine if it is easier.
More information about the openjfx-dev