[Doxygen-users] Formulas in code blocks

[Christoph L. <c_l...@po...>]

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