aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMarkus Heiser <markus.heiser@darmarIT.de>2016-08-24 11:36:14 -0400
committerJonathan Corbet <corbet@lwn.net>2016-09-01 10:49:23 -0400
commitcd21379b169827bb4314b72641511593ed9ba2b6 (patch)
tree925a7dad390c3dcaf05fbef49408ffa49bf0ac94
parentb62b9d81a06f60ae4ad5f7a9c969f5b9680e2829 (diff)
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>
-rw-r--r--Documentation/Makefile.sphinx4
1 files changed, 2 insertions, 2 deletions
diff --git a/Documentation/Makefile.sphinx b/Documentation/Makefile.sphinx
index 894cfaa41f55..92deea30b183 100644
--- a/Documentation/Makefile.sphinx
+++ b/Documentation/Makefile.sphinx
@@ -71,12 +71,12 @@ ifeq ($(HAVE_PDFLATEX),0)
71 $(warning The 'xelatex' command was not found. Make sure you have it installed and in PATH to produce PDF output.) 71 $(warning The 'xelatex' command was not found. Make sure you have it installed and in PATH to produce PDF output.)
72 @echo " SKIP Sphinx $@ target." 72 @echo " SKIP Sphinx $@ target."
73else # HAVE_PDFLATEX 73else # HAVE_PDFLATEX
74 @$(call loop_cmd,sphinx,latex,.,latex,.) 74 @$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,latex,$(var),latex,$(var)))
75endif # HAVE_PDFLATEX 75endif # HAVE_PDFLATEX
76 76
77pdfdocs: latexdocs 77pdfdocs: latexdocs
78ifneq ($(HAVE_PDFLATEX),0) 78ifneq ($(HAVE_PDFLATEX),0)
79 $(Q)$(MAKE) PDFLATEX=xelatex LATEXOPTS="-interaction=nonstopmode" -C $(BUILDDIR)/latex 79 $(foreach var,$(SPHINXDIRS), $(MAKE) PDFLATEX=xelatex LATEXOPTS="-interaction=nonstopmode" -C $(BUILDDIR)/$(var)/latex)
80endif # HAVE_PDFLATEX 80endif # HAVE_PDFLATEX
81 81
82epubdocs: 82epubdocs: