docs: Makefile: use latexmk if available (28f7c994) · Commits · 戴 / test

In the past, Sphinx was generating a LaTex Makefile that would run xelatex 3 times. Running it multiple times is needed in order to make the indexes right. However, newer versions of it runs it just once, as it expects the machine to use the "latexmk" build, with automatically detects the need for rebuilds. So, add a logic at the Makefile in order to detect if latexmk is installed. If so, it will call it. As an additional bonus, the output of latexmk is a little bit better, making easier to identify build problems. Signed-off-by:

Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Signed-off-by:

Jonathan Corbet <corbet@lwn.net>

Documentation/Makefile

+7 −2

Original line number	Diff line number	Diff line
		@@ -28,8 +28,13 @@ ifeq ($(HAVE_SPHINX),0)

		else # HAVE_SPHINX

		# User-friendly check for pdflatex
		# User-friendly check for pdflatex and latexmk
		HAVE_PDFLATEX := $(shell if which $(PDFLATEX) >/dev/null 2>&1; then echo 1; else echo 0; fi)
		HAVE_LATEXMK := $(shell if which latexmk >/dev/null 2>&1; then echo 1; else echo 0; fi)

		ifeq ($(HAVE_LATEXMK),1)
		PDFLATEX := latexmk -$(PDFLATEX)
		endif #HAVE_LATEXMK

		# Internal variables.
		PAPEROPT_a4 = -D latex_paper_size=a4
		@@ -82,7 +87,7 @@ pdfdocs:
		else # HAVE_PDFLATEX

		pdfdocs: latexdocs
		$(foreach var,$(SPHINXDIRS), $(MAKE) PDFLATEX=$(PDFLATEX) LATEXOPTS="$(LATEXOPTS)" -C $(BUILDDIR)/$(var)/latex \|\| exit;)
		$(foreach var,$(SPHINXDIRS), $(MAKE) PDFLATEX="$(PDFLATEX)" LATEXOPTS="$(LATEXOPTS)" -C $(BUILDDIR)/$(var)/latex \|\| exit;)

		endif # HAVE_PDFLATEX

Admin message