commons-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dennis Hendriks (Created) (JIRA)" <>
Subject [jira] [Created] (MATH-767) Unbalanced <code> usage in javadoc
Date Fri, 09 Mar 2012 11:42:57 GMT
Unbalanced <code> usage in javadoc

                 Key: MATH-767
             Project: Commons Math
          Issue Type: Improvement
    Affects Versions: 3.0
         Environment: n/a
            Reporter: Dennis Hendriks

See and scroll to the section 'D'. Observe
how in method discardMostRecentElements(int) in class org.apache.commons.math3.util.ResizableDoubleArray,
the style changes to larger font. As we can see in the source code for that method:

     * Discards the <code>i<code> last elements of the array.  For example,

this should become:

     * Discards the <code>i</code> last elements of the array.  For example,

as then the <code>...</code> is balanced. Or even better, it could become:

     * Discards the {@code i} last elements of the array.  For example,

This applies elsewhere as well, for instance the isSame(Chromosome) method in the org.apache.commons.math3.genetics.BinaryChromosome

We should probably check all javadoc, to make sure this is correct everywhere. Since it is
way too much to do manually, maybe a script or other automated check could detect such cases?

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:!default.jspa
For more information on JIRA, see:


View raw message