[cdi-dev] [JBoss JIRA] (CDI-316) Adopt usage of the @since Javadoc tag

Gunnar Morling (JIRA) jira-events at lists.jboss.org
Fri Mar 8 16:13:42 EST 2013


    [ https://issues.jboss.org/browse/CDI-316?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12759891#comment-12759891 ] 

Gunnar Morling commented on CDI-316:
------------------------------------

I was about to create a ticket for using @since, but then I saw that this one already exists :) The [Clirr Maven Plug-in|http://mojo.codehaus.org/clirr-maven-plugin/] could be used to create a report with all elements added in 1.1.
                
> Adopt usage of the @since Javadoc tag
> -------------------------------------
>
>                 Key: CDI-316
>                 URL: https://issues.jboss.org/browse/CDI-316
>             Project: CDI Specification Issues
>          Issue Type: Clarification
>          Components: Javadoc and API
>    Affects Versions: 1.1.PRD
>            Reporter: George Gastaldi
>             Fix For: 1.1.FD
>
>
> It's a good practice to use the @since javadoc tag in the methods and interfaces/classes created in this new version. 
> This is necessary when one need to figure out if some feature is targeted to work in 1.1 only, for example.
> This issue was created so that all the API code can be reviewed before the next release. Some classes already have this information, other still don't (@Vetoed is one that is missing, afaik)

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira


More information about the cdi-dev mailing list