Here's the simple answer. In my *class SpecMacroDocumenter(Documenter)***, define::
#: true if the generated content may contain titles titles_allowed = True (as seen in the autodoc source file) Later, in the *generate(self, ...)* method:: self.add_line(u'', '<autodoc>') for linenumber, line in enumerate(rest): self.add_line(line, macrofile, linenumber) Then all the titles are handled properly. Too simple to see. -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To view this discussion on the web visit https://groups.google.com/d/msg/sphinx-dev/-/_2DFoA3xXtgJ. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.