Re: [PATCH 1/3] doc-rst: generic way to build only sphinx sub-folders

Jonathan Corbet
2016-08-12T21:20:22Z

On Mon, 8 Aug 2016 15:14:58 +0200
Markus Heiser <markus.heiser@darmarit.de> wrote:

> Remove the 'DOC_NITPIC_TARGETS' from main $(srctree)/Makefile and add a
> more generic way to build only a reST sub-folder.
>
> * 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.

So I went to apply these, but this one, at least, doesn't apply. Could I
get you to respin the series against current mainline (or docs-next)?

Thanks,

jon