Re: make pdfdocs fails on Debian stable

[Mauro Carvalho Chehab <mchehab@kernel.org>]

Em Mon, 3 Jan 2022 17:30:50 +0100
Christoph Hellwig <hch@lst.de> escreveu:

> Hi Jon and Mauro,
> 
> when trying to do a make pdfdocs on my Debian stable system I can't
> get it to complete.  The output below is from linux-next, but mainline
> is the same.
> 
> ------------
> Running 'xelatex --no-pdf -interaction=batchmode -no-pdf -recorder  "RCU.tex"'
> ------------
> This is XeTeX, Version 3.14159265-2.6-0.999992 (TeX Live 2020/Debian) (preloaded format=xelatex)
> restricted \write18 enabled.
>  entering extended mode
> Latexmk: Examining 'RCU.log'
> === TeX engine is 'XeTeX'
> Latexmk: Index file 'RCU.idx' was written
> Latexmk: References changed.
> Latexmk: Log file says output to 'RCU.xdv'
> Latexmk: Errors, so I did not complete making targets
> Collected error summary (may duplicate other messages):
>   xelatex: Command for 'xelatex' gave return code 1
>     Refer to 'RCU.log' for details
> Latexmk: Use the -f option to force complete processing,
>   unless error was exceeding maximum runs, or warnings treated as errors.
> make[2]: *** [Makefile:29: RCU.pdf] Error 12
> make[1]: *** [Documentation/Makefile:115: pdfdocs] Error 2
> make: *** [Makefile:1772: pdfdocs] Error 2
> 

Weird... when you do a make, it should have checked for all
dependencies, when it internally runs:

	./scripts/sphinx-pre-install 

Basically, you need the xelatex package for it to work, as PDF
output is via LaTeX. This is not a mandatory requirement, though,
as most people are only interested on html output, and LaTeX
dependencies require to install lots of stuff. it should provide you
a list of packages required for PDF, with a suggestion of using
apt-get to install it.

In this specific case, I guess the package name is 'texlive-xetex'.

Thanks,
Mauro