On Sat, 13 Aug 2016 16:12:42 +0200 Markus Heiser <markus.hei...@darmarit.de> wrote:
> 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. So this patch appears to have had the undocumented effect of moving HTML output from Documentation/output/html to Documentation/output. I am assuming that was not the intended result? I'm not sure that we actually need the format-specific subfolders, but we should be consistent across all the formats and in the documentation and, as of this patch, we're not. jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
