docs: Makefile: use latexmk if available
authorMauro Carvalho Chehab <mchehab+samsung@kernel.org>
Sat, 30 Mar 2019 13:45:58 +0000 (10:45 -0300)
committerJonathan Corbet <corbet@lwn.net>
Mon, 1 Apr 2019 20:33:42 +0000 (14:33 -0600)
commit28f7c994255a9811caa17253353036559852c99c
tree3ad31d5f20274b778ae909300491f9a844304164
parent6c5d24eef7be7adfcb608f2852ab69b58935133b
docs: Makefile: use latexmk if available

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