+1 and I'd love to see that patch. It begs the question: "Do we have/need a criteria for removing the @Experimental designation?"

On 12/22/11 5:01 PM, Ted Dunning wrote:
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




Reply via email to