Fixes #795: explain that titles on the same level as the document heading cannot be put into only directives.

This commit is contained in:
Georg Brandl 2012-03-10 21:21:43 +01:00
parent fae8a17026
commit 729565b7a9

View File

@ -182,6 +182,13 @@ Including content based on tags
The format of the current builder (``html``, ``latex`` or ``text``) is always
set as a tag.
.. note::
Due to docutils' specifics of parsing of directive content, you cannot put
a section with the same level as the main document heading inside an
``only`` directive. Such sections will appear to be ignored in the parsed
document.
.. versionadded:: 0.6