diff --git a/doc/config.rst b/doc/config.rst
index 70ccd26eb..f57e9effa 100644
--- a/doc/config.rst
+++ b/doc/config.rst
@@ -118,7 +118,7 @@ General configuration
    in that case.
 
    .. deprecated:: 1.0
-      Use :confval:`exclude_patterns` instead.
+      Use :confval:`exclude_patterns` or :ref:`metadata` instead.
 
 .. confval:: exclude_trees
 
diff --git a/doc/markup/toctree.rst b/doc/markup/toctree.rst
index c17fb9b07..53fa1faea 100644
--- a/doc/markup/toctree.rst
+++ b/doc/markup/toctree.rst
@@ -141,8 +141,8 @@ tables of contents.  The ``toctree`` directive is the central element.
    In the end, all documents in the :term:`source directory` (or subdirectories)
    must occur in some ``toctree`` directive; Sphinx will emit a warning if it
    finds a file that is not included, because that means that this file will not
-   be reachable through standard navigation.  Use :confval:`unused_docs` to
-   explicitly exclude documents from building, and :confval:`exclude_trees` to
+   be reachable through standard navigation.  Use :ref:`metadata` to
+   remove the warning,, and :confval:`exclude_patterns` to
    exclude whole directories.
 
    The "master document" (selected by :confval:`master_doc`) is the "root" of