diff options
author | Markus Heiser <markus.heiser@darmarIT.de> | 2016-08-24 11:36:14 -0400 |
---|---|---|
committer | Jonathan Corbet <corbet@lwn.net> | 2016-09-01 10:49:23 -0400 |
commit | cd21379b169827bb4314b72641511593ed9ba2b6 (patch) | |
tree | 925a7dad390c3dcaf05fbef49408ffa49bf0ac94 | |
parent | b62b9d81a06f60ae4ad5f7a9c969f5b9680e2829 (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.sphinx | 4 |
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." |
73 | else # HAVE_PDFLATEX | 73 | else # HAVE_PDFLATEX |
74 | @$(call loop_cmd,sphinx,latex,.,latex,.) | 74 | @$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,latex,$(var),latex,$(var))) |
75 | endif # HAVE_PDFLATEX | 75 | endif # HAVE_PDFLATEX |
76 | 76 | ||
77 | pdfdocs: latexdocs | 77 | pdfdocs: latexdocs |
78 | ifneq ($(HAVE_PDFLATEX),0) | 78 | ifneq ($(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) |
80 | endif # HAVE_PDFLATEX | 80 | endif # HAVE_PDFLATEX |
81 | 81 | ||
82 | epubdocs: | 82 | epubdocs: |