> On Apr 5, 2019, at 5:12 AM, Alex Herbert <alex.d.herb...@gmail.com> wrote:
>
>> 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) \)
>
I suppose that depends on one’s familiarity with LaTeX :-p
Definitely a fair point because the above is indeed ugly
>
> [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
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
For additional commands, e-mail: dev-h...@commons.apache.org
