title: Using '\displaymath' directives in docstrings formulas
body: <p>I am using the Sphinx documentation package to document a small Python tool kit that I am working on and I would like to describe the mathematical formulas that the various modules implement by listing them in LaTeX format in the Python docstrings.</p>
  
  <p>It is pretty easy to achieve this with <code>:math:</code> or <code>.. math::</code> directives for reStructuredText, for example:</p>
  
  <pre><code>.. math::
     \\displaymath \\sum_{i=1}^{\\infty} x_{i}
  </code></pre>
  
  <p>but the <code>\\displaymath</code> directive is just highlighted as red text when in a Python docstring. When used in a <code>.rst</code> file (e.g. <code>index.rst</code>) this works as expected, and the sub- and super-scripts for the summation are directly below and above the summation symbol.</p>
  
  <p>Is this simply not supported for docstrings, or am I doing something wrong or not doing something that I need to be doing?</p>