diff --git a/doc/markup/misc.rst b/doc/markup/misc.rst
index f746c6a71dc..c4b64e39c03 100644
--- 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
 ------