Issues

Issue #556 resolved

Docstring of automodule does not start a new paragraph in LaTeX, but in HTML

hmgaudecker
created an issue

In the following example, the behaviour will differ between LaTeX and HTML output:

{{{ This is a simple test paragraph.

.. automodule:: foo :members: bar }}}

The docstring of the module will end up in the same paragraph as the previous line in LaTeX, but not in HTML. The latter behaviour seems to be more sensible.

A workaround is to place

{{{

.. raw:: latex

\\

}}}

before the automodule directive, but that has some issues in terms of formatting, spacing, etc. -- aside from being ugly.

Comments (3)

  1. Log in to comment