Formulas in code blocks

Christoph Lehmann <[email protected]>
Newsgroups gmane.text.doxygen.general
Message-ID <[email protected]>
Dear all,

I just found out by chance that formulas can be included in code
snippets if MathJax is enabled. In the following examples \sum will be
rendered as the respective LaTeX symbol in the HTML output.

\code
while true; do
    \( \sum \)
done
\endcode

~~~~~
while true; do
    \( \sum \)
done
~~~~~

However, I could not find that behaviour documented anywhere and
actually I found out about it when trying to include the following
snippet into the documentation:

\code
find . \( -name '*.h' -and -not -name '*-impl.h' \) -printf '%f\n'
\endcode

Everything between the brackets was interpreted as some LaTeX formula
and thus messed up pretty much. That also applies if I specify
{.unparsed} as "language".

Is the observed behaviour intended or is it merely a bug? Is there some
documentation somewhere? As a feature it would be very nice, but is
there also a possibility to disable the special meaning of \( and \) in
code snippets?

Best regards,
Christoph

------------------------------------------------------------------------------
Site24x7 APM Insight: Get Deep Visibility into Application Performance
APM + Mobile APM + RUM: Monitor 3 App instances at just $35/Month
Monitor end-to-end web transactions and take corrective actions now
Troubleshoot faster and improve end-user experience. Signup Now!
http://pubads.g.doubleclick.net/gampad/clk?id=272487151&iu=/4140
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.