>> 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. Richard