Blame view
Documentation/Makefile.sphinx
3.72 KB
22cba31ba Documentation/sph... |
1 2 3 4 5 6 7 |
# -*- makefile -*- # Makefile for Sphinx documentation # # You can set these variables from the command line. SPHINXBUILD = sphinx-build SPHINXOPTS = |
606b9ac81 doc-rst: generic ... |
8 9 10 |
SPHINXDIRS = . _SPHINXDIRS = $(patsubst $(srctree)/Documentation/%/conf.py,%,$(wildcard $(srctree)/Documentation/*/conf.py)) SPHINX_CONF = conf.py |
22cba31ba Documentation/sph... |
11 12 13 14 15 16 17 18 19 20 21 |
PAPER = BUILDDIR = $(obj)/output # User-friendly check for sphinx-build HAVE_SPHINX := $(shell if which $(SPHINXBUILD) >/dev/null 2>&1; then echo 1; else echo 0; fi) ifeq ($(HAVE_SPHINX),0) .DEFAULT: $(warning The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed and in PATH, or set the SPHINXBUILD make variable to point to the full path of the '$(SPHINXBUILD)' executable.) @echo " SKIP Sphinx $@ target." |
6387872c8 Documentation/sph... |
22 23 24 25 26 |
else ifneq ($(DOCBOOKS),) # Skip Sphinx build if the user explicitly requested DOCBOOKS. .DEFAULT: @echo " SKIP Sphinx $@ target (DOCBOOKS specified)." |
22cba31ba Documentation/sph... |
27 |
else # HAVE_SPHINX |
f907ba930 Documentation: sw... |
28 29 |
# User-friendly check for pdflatex HAVE_PDFLATEX := $(shell if which pdflatex >/dev/null 2>&1; then echo 1; else echo 0; fi) |
22cba31ba Documentation/sph... |
30 31 32 33 |
# Internal variables. PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_letter = -D latex_paper_size=letter |
24dcdeb28 Documentation/sph... |
34 35 |
KERNELDOC = $(srctree)/scripts/kernel-doc KERNELDOC_CONF = -D kerneldoc_srctree=$(srctree) -D kerneldoc_bin=$(KERNELDOC) |
606b9ac81 doc-rst: generic ... |
36 |
ALLSPHINXOPTS = $(KERNELDOC_CONF) $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) |
22cba31ba Documentation/sph... |
37 38 |
# the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . |
606b9ac81 doc-rst: generic ... |
39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
# commands; the 'cmd' from scripts/Kbuild.include is not *loopable* loop_cmd = $(echo-cmd) $(cmd_$(1)) # $2 sphinx builder e.g. "html" # $3 name of the build subfolder / e.g. "media", used as: # * dest folder relative to $(BUILDDIR) and # * cache folder relative to $(BUILDDIR)/.doctrees # $4 dest subfolder e.g. "man" for man pages at media/man # $5 reST source folder relative to $(srctree)/$(src), # e.g. "media" for the linux-tv book-set at ./Documentation/media quiet_cmd_sphinx = SPHINX $@ --> file://$(abspath $(BUILDDIR)/$3/$4); cmd_sphinx = $(MAKE) BUILDDIR=$(abspath $(BUILDDIR)) $(build)=Documentation/media all;\ BUILDDIR=$(abspath $(BUILDDIR)) SPHINX_CONF=$(abspath $(srctree)/$(src)/$5/$(SPHINX_CONF)) \ $(SPHINXBUILD) \ -b $2 \ -c $(abspath $(srctree)/$(src)) \ -d $(abspath $(BUILDDIR)/.doctrees/$3) \ -D version=$(KERNELVERSION) -D release=$(KERNELRELEASE) \ $(ALLSPHINXOPTS) \ $(abspath $(srctree)/$(src)/$5) \ $(abspath $(BUILDDIR)/$3/$4); |
22cba31ba Documentation/sph... |
61 62 |
htmldocs: |
606b9ac81 doc-rst: generic ... |
63 |
@$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,html,$(var),,$(var))) |
22cba31ba Documentation/sph... |
64 65 |
pdfdocs: |
f907ba930 Documentation: sw... |
66 67 |
ifeq ($(HAVE_PDFLATEX),0) $(warning The 'pdflatex' command was not found. Make sure you have it installed and in PATH to produce PDF output.) |
22cba31ba Documentation/sph... |
68 |
@echo " SKIP Sphinx $@ target." |
f907ba930 Documentation: sw... |
69 |
else # HAVE_PDFLATEX |
606b9ac81 doc-rst: generic ... |
70 |
@$(call loop_cmd,sphinx,latex,.,latex,.)) |
f907ba930 Documentation: sw... |
71 72 |
$(Q)$(MAKE) -C $(BUILDDIR)/latex endif # HAVE_PDFLATEX |
22cba31ba Documentation/sph... |
73 74 |
epubdocs: |
606b9ac81 doc-rst: generic ... |
75 |
@$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,epub,$(var),epub,$(var))) |
22cba31ba Documentation/sph... |
76 77 |
xmldocs: |
606b9ac81 doc-rst: generic ... |
78 |
@$(foreach var,$(SPHINXDIRS),$(call loop_cmd,sphinx,xml,$(var),xml,$(var))) |
22cba31ba Documentation/sph... |
79 80 81 82 83 84 85 86 87 |
# no-ops for the Sphinx toolchain sgmldocs: psdocs: mandocs: installmandocs: cleandocs: $(Q)rm -rf $(BUILDDIR) |
d9a77fe24 Documentation/sph... |
88 |
endif # HAVE_SPHINX |
ebc88ef05 Documentation: ad... |
89 90 91 92 93 94 95 |
dochelp: @echo ' Linux kernel internal documentation in different formats (Sphinx):' @echo ' htmldocs - HTML' @echo ' pdfdocs - PDF' @echo ' epubdocs - EPUB' @echo ' xmldocs - XML' @echo ' cleandocs - clean all generated files' |
606b9ac81 doc-rst: generic ... |
96 97 98 99 100 101 |
@echo @echo ' make SPHINXDIRS="s1 s2" [target] Generate only docs of folder s1, s2' @echo ' valid values for SPHINXDIRS are: $(_SPHINXDIRS)' @echo @echo ' make SPHINX_CONF={conf-file} [target] use *additional* sphinx-build' @echo ' configuration. This is e.g. useful to build with nit-picking config.' |