1. 15 8月, 2016 1 次提交
    • M
      doc-rst: generic way to build only sphinx sub-folders · 606b9ac8
      Markus Heiser 提交于
      Add a generic way to build only a reST sub-folder with or
      without a individual *build-theme*.
      
      * control *sub-folders* by environment SPHINXDIRS
      * control *build-theme* by environment SPHINX_CONF
      
      Folders with a conf.py file, matching $(srctree)/Documentation/*/conf.py
      can be build and distributed *stand-alone*. E.g. to compile only the
      html of 'media' and 'gpu' folder use::
      
        make SPHINXDIRS="media gpu" htmldocs
      
      To use an additional sphinx-build configuration (*build-theme*) set the
      name of the configuration file to SPHINX_CONF. E.g. to compile only the
      html of 'media' with the *nit-picking* build use::
      
        make SPHINXDIRS=media SPHINX_CONF=conf_nitpick.py htmldocs
      
      With this, the Documentation/conf.py is read first and updated with the
      configuration values from the Documentation/media/conf_nitpick.py.
      Signed-off-by: NMarkus Heiser <markus.heiser@darmarIT.de>
      Signed-off-by: NJonathan Corbet <corbet@lwn.net>
      606b9ac8