[ 
https://issues.apache.org/jira/browse/MATH-1044?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13801804#comment-13801804
 ] 

Gilles commented on MATH-1044:
------------------------------

If you know (and like) LaTeX, it is now possible to write formulae with it 
within the Javadoc (thanks to MathJax).
Interpretation is activated by having an inline formula enclosed between 
{noformat}\({noformat} and {noformat}\){noformat} and a display formula 
enclosed between {noformat}\[{noformat}  and {noformat}\]{noformat}
See for example the doc of class 
{{org.apache.commons.math3.fitting.HarmonicCurveFitter}}.


> Clarify and fix javadoc of DecompositionSolver.getInverse() and 
> implementations
> -------------------------------------------------------------------------------
>
>                 Key: MATH-1044
>                 URL: https://issues.apache.org/jira/browse/MATH-1044
>             Project: Commons Math
>          Issue Type: Improvement
>    Affects Versions: 3.2
>            Reporter: Sean Owen
>            Priority: Minor
>              Labels: decomposition, inverse, singular, solver
>         Attachments: MATH-1044.patch
>
>
> As suggested by Phil on the mailing list, I'm providing a patch to the 
> javadoc of DecompositionSolver.getInverse() to clarify what it does. It also 
> correctly moves the "@throws SingularMatrixException" to implementations that 
> do throw this exception; not all do.
> Tests already cover most of the behavior asserted by the documentation. I 
> added one to show that the SVD does not reject singular matrices. There 
> should be a test for EigenDecomposition here too, but in the course of adding 
> it I found another apparent small bug in its behavior with singular matrices. 
> So I will provide that separately (it actually involves no doc changes, and 
> docs are the topic here.)



--
This message was sent by Atlassian JIRA
(v6.1#6144)

Reply via email to