title: sphinx severe: unexpected section title -- arbitrary headings in function docstring
body: <p>Using <a href="http://sphinx-doc.org/ext/autodoc.html" rel="nofollow noreferrer"><code>autodoc</code></a> and similar tools allows one to compile documentation from source <strong>docstrings</strong>. It doesn't however, seem to allow arbitrary ReST section titles in function or class docstrings, and produces the error: </p>
  
  <p><code>SEVERE: Unexpected section title.</code></p>
  
  <p>I encoutered a similar problem when trying to document following the numpy style guidelines without <code>numpydoc</code>: <a href="https://stackoverflow.com/questions/3101281/unexpected-section-title-with-sphinx-is-numpy-the-issue">unexpected section title with sphinx is numpy the issue</a> and
  <a href="https://stackoverflow.com/questions/17397483/how-does-numpy-process-docstrings-into-sphinx-documentation-for-parameters">how does numpy process docstrings into sphinx documentation for parameters</a></p>
  
  <p>Here however, I'm actually documenting JavaScript and would simply like to have arbitrary section titles and ReST in a <strong>docstring</strong>.</p>
  
  <p>Javascript docstring api: <a href="https://github.com/Nuulogic/sphinx-jsapidoc" rel="nofollow noreferrer">sphinx jsapidoc</a></p>