on master help sign in
[enh] add 'kernel-include' reST-directive
aa5f947Markus Heiser
docs/conf.py+1
@@ -66,6 +66,7 @@ extensions = [
66 "sphinx_issues", # https://github.com/sloria/sphinx-issues/blob/master/README.rst
66 "sphinx_issues", # https://github.com/sloria/sphinx-issues/blob/master/README.rst
67 "sphinxcontrib.jinja", # https://github.com/tardyp/sphinx-jinja
67 "sphinxcontrib.jinja", # https://github.com/tardyp/sphinx-jinja
68 "sphinxcontrib.programoutput", # https://github.com/NextThought/sphinxcontrib-programoutput
68 "sphinxcontrib.programoutput", # https://github.com/NextThought/sphinxcontrib-programoutput
69+ 'linuxdoc.kernel_include', # Implementation of the 'kernel-include' reST-directive.
69 'linuxdoc.rstFlatTable', # Implementation of the 'flat-table' reST-directive.
70 'linuxdoc.rstFlatTable', # Implementation of the 'flat-table' reST-directive.
70 'linuxdoc.kfigure', # Sphinx extension which implements scalable image handling.
71 'linuxdoc.kfigure', # Sphinx extension which implements scalable image handling.
71 "sphinx_tabs.tabs", # https://github.com/djungelorm/sphinx-tabs
72 "sphinx_tabs.tabs", # https://github.com/djungelorm/sphinx-tabs
docs/dev/reST.rst+3−2
@@ -325,8 +325,9 @@ Literal blocks
325
325
326The simplest form of :duref:`literal-blocks` is a indented block introduced by
326The simplest form of :duref:`literal-blocks` is a indented block introduced by
327two colons (``::``). For highlighting use :dudir:`highlight` or :ref:`reST
327two colons (``::``). For highlighting use :dudir:`highlight` or :ref:`reST
328−code` directive. To include literals from external files use directive
328+code` directive. To include literals from external files use
329−:rst:dir:`literalinclude`.
329+:rst:dir:`literalinclude` or :ref:`kernel-include <kernel-include-directive>`
330+directive (latter one expands environment variables in the path name).
330
331
331.. _reST literal:
332.. _reST literal:
332
333