Re: make pdfdocs fails on Debian stable

[Akira Yokosawa <akiyks@gmail.com>]

Hi Christoph,

On Tue, 4 Jan 2022 07:47:08 +0100, Christoph Hellwig wrote:
> On Mon, Jan 03, 2022 at 09:58:31PM +0100, Mauro Carvalho Chehab wrote:
>> Ah, the error is specific to RCU.tex then?
> 
> Yes.
> 
>> 
>> You'll need to re-run xelatex with -interaction=interactive, in
>> order to be able to identify what's the root cause.
>> 
>> You could do this by using LATEXOPTS, e. g.:
>> 
>> 	$ make SPHINXDIRS=RCU LATEXOPTS="-interaction=interactive" pdfdocs
>> 
>> With that, LaTeX will stop at the offending line from the .tex file.
>> 
>> On a quick test here, I'm getting these at Fedora 35:
>> 
>> 	(/usr/share/texlive/texmf-dist/tex/latex/l3packages/xtemplate/xtemplate.sty)
>> 
>> 	! LaTeX Error: File `ctexhook.sty' not found.
>> 
>> 	Type X to quit or <RETURN> to proceed,
>> 	or enter new name. (Default extension: sty)
>> 
>> It seems that a recent change (probably to better address issues with 
>> Chinese and Japanese translation) added an extra dependency to some
>> stylesheet.
>> 
>> I solved it by installing this package: "texlive-ctex".
> 
> There is no texlive-ctex on Debian, but ctexhook.sty is installed as
> part of texlive-extra-utils.  Here are the last lines from the
> interactive run:
> 
> (/usr/share/texlive/texmf-dist/tex/latex/ctex/ctexhook.sty)
> (/usr/share/texlive/texmf-dist/tex/xelatex/xecjk/xeCJK.cfg))
> (/usr/share/texlive/texmf-dist/tex/latex/etoolbox/etoolbox.sty)
> Writing index file RCU.idx
> (./RCU.aux)
> Runaway argument?
> {\contentsline {chapter}{\numberline {16}A Tour Through TREE\_RCU’s\ETC.
> ! File ended while scanning use of \@writefile.
> <inserted text> 
>                 \par 
> l.191 \begin{document}
> 
> ? 

I suspect you are suffering from corrupt RCU.aux (or whatever other
intermediate files xelatex generates).

What happens you run

    $ make cleandocs

before

    $ make SPHINXDIRS=RCU LATEXOPTS="-interaction=interactive" pdfdocs

?

        Thanks, Akira