autodoc_sections doesn't mix well with :param: et al
Created originally on Bitbucket by Anonymous
When using the autodoc_sections
extension, inserting :param foo:
or similar directives within a nested section results in the directive getting rendered literally. It works fine if the directive is placed before the start of nested section. Not sure if this is bug in sphinx, or (more probably) in how autodoc_sections
is processing the docstrings.