From 729565b7a91ac2d07031aabce435b9030496934a Mon Sep 17 00:00:00 2001 From: Georg Brandl Date: Sat, 10 Mar 2012 21:21:43 +0100 Subject: [PATCH] Fixes #795: explain that titles on the same level as the document heading cannot be put into only directives. --- doc/markup/misc.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/markup/misc.rst b/doc/markup/misc.rst index f5eaac9ce..3a2ffa32e 100644 --- a/doc/markup/misc.rst +++ b/doc/markup/misc.rst @@ -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