On 05/04/2019 09:27, sebb wrote:
On Tue, 12 Mar 2019 at 12:28, Rob Tompkins <chtom...@gmail.com> wrote:
For those unfamiliar with MathJaX, is the javascript mechanism for
accommodating for LaTeX (the math typesetting language, written by Donald
Knuth) in html.
It could be convenient to use mathematical notation in our javadoc generally.
That said, Java doesn’t do this so it would indeed be non-standard. My opinion
is in the +0.5 zone currently.
Thoughts?
Is it likely that existing Javadoc comments will trigger MathJaX?
That would perhaps mean lots of changes just to stay still.
What does it look like if JavaScript is not in use?
Not very readable. Have a look at this page:
http://commons.apache.org/proper/commons-math/javadocs/api-3.6.1/org/apache/commons/math3/analysis/polynomials/PolynomialsUtils.html
Then turn off Javascript (e.g. [1]) and look again.
An example non-javascript output for an equation (method
createJacobiPolynomial(int, int, int)) is:
\( P_0^{vw}(x) = 1 \\ P_{-1}^{vw}(x) = 0 \\ 2k(k + v + w)(2k + v + w -
2) P_k^{vw}(x) = \\ (2k + v + w - 1)[(2k + v + w)(2k + v + w - 2) x +
v^2 - w^2] P_{k-1}^{vw}(x) \\ - 2(k + v - 1)(k + w - 1)(2k + v + w)
P_{k-2}^{vw}(x) \)
[1] https://www.lifewire.com/disable-javascript-in-google-chrome-4103631
I think it would be sensible for the processing to be optional, e.g.
via a marker file.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org
