doc: add sphinx extension improving only directive

The Sphinx .. only:: directive is limited to handling only conditional
text and can't handling conditional use of directives.  For example,

.. only:: test

   .. automodule:: west.runners.core
      :members:

is not handled.  This PR monkey patches the handling of the existing
.. only:: directive done by Sphinx.

See https://github.com/pfalcon/sphinx_selective_exclude for details.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
David B. Kinder
2018-11-29 14:26:02 -08:00
committed by David Kinder
parent 0bc85d2ebc
commit e0260b4496
2 changed files with 47 additions and 1 deletions

View File

@@ -35,7 +35,8 @@ if "RELEASE" in os.environ:
# ones.
sys.path.insert(0, os.path.join(os.path.abspath('.'), 'extensions'))
extensions = ['breathe', 'sphinx.ext.graphviz', 'sphinx.ext.extlinks', 'kerneldoc']
extensions = ['breathe', 'sphinx.ext.graphviz', 'sphinx.ext.extlinks',
'kerneldoc', 'eager_only']
# extlinks provides a macro template