In my small test, these annotations did appear in the javadoc. The trick is the @Documented meta-annotation.
I don't know what Retention and Target should mean. This was my beef with Maturity as well. If there is a natural meaning that I am missing then it would be fine. Once we converge on an annotation scheme, I will produce and commit a mega-patch that adds these annotations to lots of classes. On Thu, Dec 22, 2011 at 3:55 PM, Dmitriy Lyubimov (Commented) (JIRA) < [email protected]> wrote: > > [ > https://issues.apache.org/jira/browse/MAHOUT-831?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13175173#comment-13175173] > > Dmitriy Lyubimov commented on MAHOUT-831: > ----------------------------------------- > > is it appearing in javadoc with the metadata? Looks good. > > I would also add > {code} > > @Retention(RetentionPolicy.CLASS) > @Target(ElementType.TYPE) > {code} > > to indicate appropriate use. > > > @Experimental annotation to indicate which implementations are not > intended for production use > > > ---------------------------------------------------------------------------------------------- > > > > Key: MAHOUT-831 > > URL: https://issues.apache.org/jira/browse/MAHOUT-831 > > Project: Mahout > > Issue Type: Improvement > > Affects Versions: 0.6 > > Reporter: Sebastian Schelter > > Assignee: Sebastian Schelter > > Attachments: MAHOUT-831-2.patch, MAHOUT-831.patch, > MAHOUT-831.patch > > > > > > > -- > This message is automatically generated by JIRA. > If you think it was sent incorrectly, please contact your JIRA > administrators: > https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa > For more information on JIRA, see: http://www.atlassian.com/software/jira > > >
