Hi all,

in the NIPY documentation, we're heavily taking advantage of mpl's

math support, and for the most part it's working great. But having it

in there, we may have gotten a bit carried away... If you look at this

page:

http://neuroimaging.scipy.org/site/doc/manual/html/users/glm_spec.html

its reST sources here:

http://neuroimaging.scipy.org/site/doc/manual/html/_sources/users/glm_spec.txt

Contain text like:

/begin quote

"""

Typically, the events occur in groups, say odd events are labelled

*a*, even ones *b*. We might rewrite this as

.. math::

E = \delta_{(t_1,a)} + \delta_{(t_2,b)} + \delta_{(t_3,a)} + \dots +

\delta_{t_{10},b}

This type of experiment can be represented by two counting processes

:math:`(E_a, E_b)` defined as

.. math::

\begin{aligned}

E_a(t) &= \sum_{t_j, \text{$j$ odd}} 1_{\{t_j \leq t\}} \\

E_b(t) &= \sum_{t_j, \text{$j$ even}} 1_{\{t_j \leq t\}}

\end{aligned}

These delta-function responses are effectively events of duration 0

and infinite height.

""" / end quote

In the final PDF

(http://neuroimaging.scipy.org/site/doc/manual/nipy.pdf) that all

renders fine, since it's 'real' latex doing the work. However, the

HTML linked above renders the first equation fine, while the multiline

one doesn't work.

Is this something possible with today's MPL but where we are just not

making the right calls, or is it a missing feature. If the latter, is

it realistic to expect it to be added, or should we rather plan for

avoiding such type of typesetting in our docs or switching math

engines for the html docs? Or is the feature 'almost there' but

slightly buggy?

Any hints much appreciated, I just wasn't sure whether this would be a

bug report, feature request or just seeking advice...

Cheers,

f