accumulo-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Christopher Tubbs (JIRA)" <>
Subject [jira] [Commented] (ACCUMULO-1031) Modify Code template to not automatically insert javadocs
Date Tue, 05 Feb 2013 18:52:12 GMT


Christopher Tubbs commented on ACCUMULO-1031:

If it helps, the Eclipse settings I use for checking Javadoc formatting are:
Java -> Compiler -> Javadoc
  Process Javadoc comments = (checked)
    Malformed Javadoc comments = "Warning"
      Only consider members as visible as = "Protected"
      Validate tag arguments = (checked)
        Report nonvisible references = (checked)
        Report deprecated references = (checked)
      Missing tag descriptions = "Validate all standard tags" (sometimes I just use "Validate
@return tags")
    Missing Javadoc tags = "Ignore"
    Missing Javadoc comments = "Ignore"
> Modify Code template to not automatically insert javadocs
> ---------------------------------------------------------
>                 Key: ACCUMULO-1031
>                 URL:
>             Project: Accumulo
>          Issue Type: Task
>            Reporter: Christopher Tubbs
>            Assignee: Christopher Tubbs
>             Fix For: 1.5.0
> There are too many javadocs that either provide no value, or are malformed. Javadocs
should be a conscious thing, where we take care to document what is important. Ideally, we
could take this care every time we create a method, and again every time we update it. However,
the reality is, these tend to get generated and ignored.
> See conversation on the [dev mailing list|].

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:

View raw message