doc: Add warning for only directive (refs: #3539)

sphinx-doc · Mar 11, 2017 · db6e1db · db6e1db
1 parent 0f8abd1
commit db6e1db
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/doc/markup/misc.rst b/doc/markup/misc.rst
@@ -201,6 +201,11 @@ Including content based on tags
    .. versionchanged:: 1.2
       Added the name of the builder and the prefixes.
 
+   .. warning::
+
+      This directive is designed to control only content of document.  It could
+      not control sections, labels and so on.
+
 
 Tables
 ------