Merged in plaindocs/sphinx (pull request #185)

This commit is contained in:
Georg Brandl 2014-01-10 09:24:23 +01:00
commit fcee847ae0
2 changed files with 4 additions and 3 deletions

View File

@ -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

View File

@ -141,8 +141,9 @@ 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:`exclude_patterns` to
explicitly exclude documents or directories from building.
be reachable through standard navigation. Use :ref:`metadata` to remove the
warning, and :confval:`exclude_patterns` to explicitly exclude documents or
directories from building.
The "master document" (selected by :confval:`master_doc`) is the "root" of
the TOC tree hierarchy. It can be used as the documentation's main page, or