You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "Thomas Neidhart (Resolved) (JIRA)" <ji...@apache.org> on 2012/04/01 19:50:32 UTC
[jira] [Resolved] (MATH-767) Unbalanced usage in javadoc
[ https://issues.apache.org/jira/browse/MATH-767?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Thomas Neidhart resolved MATH-767.
----------------------------------
Resolution: Fixed
> Unbalanced <code> usage in javadoc
> ----------------------------------
>
> Key: MATH-767
> URL: https://issues.apache.org/jira/browse/MATH-767
> Project: Commons Math
> Issue Type: Improvement
> Affects Versions: 3.0
> Environment: n/a
> Reporter: Dennis Hendriks
> Labels: javadoc
> Fix For: 3.1
>
>
> See http://commons.apache.org/math/apidocs/index-all.html 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:
> {code}
> * Discards the <code>i<code> last elements of the array. For example,
> {code}
> this should become:
> {code}
> * Discards the <code>i</code> last elements of the array. For example,
> {code}
> as then the <code>...</code> is balanced. Or even better, it could become:
> {code}
> * Discards the {@code i} last elements of the array. For example,
> {code}
> This applies elsewhere as well, for instance the isSame(Chromosome) method in the org.apache.commons.math3.genetics.BinaryChromosome class.
> 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: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira