Similarly to the Java SE API docs, @since tags only need to be added to classes or methods that were added post RHQ 1.0 (i.e. no @since tag would imply the class or method has existed since RHQ 1.0). This will make our HTML API docs more useful, since users will be able to see when various methods got added to the API.
Created attachment 530375 [details] adds @since tags to all plugin API classes, except those under content and util packages
The attached patch has been applied and committed to master: http://git.fedorahosted.org/git/?p=rhq/rhq.git;a=commitdiff;h=ee49856 However, I think a few classes still need @since tags. I will review them before closing this BZ.
commit 181e5e7844c6bbe9972d863eb734190631c53fba Author: Jay Shaughnessy <jshaughn> Date: Tue Jul 22 16:18:57 2014 -0400 [749368] add @since Javadoc tags to our public APIs Went through our intentional-changes files and added agfew missing @since tags that seemed maybe useful. I had previously updated the server's SLSB remote API, just added 4.12 for that.
Moving to ON_QA as available to test with brew build of DR01: https://brewweb.devel.redhat.com//buildinfo?buildID=373993