doc-rst: generic way to build PDF of sub-folders
authorMarkus Heiser <markus.heiser@darmarIT.de>
Wed, 24 Aug 2016 15:36:14 +0000 (17:36 +0200)
committerJonathan Corbet <corbet@lwn.net>
Thu, 1 Sep 2016 14:49:23 +0000 (08:49 -0600)
commitcd21379b169827bb4314b72641511593ed9ba2b6
tree925a7dad390c3dcaf05fbef49408ffa49bf0ac94
parentb62b9d81a06f60ae4ad5f7a9c969f5b9680e2829
doc-rst: generic way to build PDF of sub-folders

This extends the method to build only sub-folders to the targets
"latexdocs" and "pdfdocs". To do so, a conf.py in the sub-folder is
required, where the latex_documents of the sub-folder are
defined. E.g. to build only gpu's PDF add the following to the
Documentation/gpu/conf.py::

  +latex_documents = [
  +    ("index", "gpu.tex", "Linux GPU Driver Developer's Guide",
  +     "The kernel development community", "manual"),
  +]

and run:

  make SPHINXDIRS=gpu pdfdocs

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/Makefile.sphinx