To:     hch@lst.de
Cc:     corbet@lwn.net, linux-doc@vger.kernel.org,
        linux-kernel@vger.kernel.org, mchehab@kernel.org
References: <20220104064708.GA15446@lst.de>
Subject: Re: make pdfdocs fails on Debian stable
From:   Akira Yokosawa <akiyks@gmail.com>
Message-ID: <8f21b702-abc2-c9aa-7593-9aff17e61ed1@gmail.com>
Date:   Tue, 4 Jan 2022 16:32:14 +0900
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101
 Thunderbird/78.14.0
MIME-Version: 1.0
In-Reply-To: <20220104064708.GA15446@lst.de>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: quoted-printable
Precedence: bulk

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?
>=20
> Yes.
>=20
>>=20
>> You'll need to re-run xelatex with -interaction=3Dinteractive, in
>> order to be able to identify what's the root cause.
>>=20
>> You could do this by using LATEXOPTS, e. g.:
>>=20
>> 	$ make SPHINXDIRS=3DRCU LATEXOPTS=3D"-interaction=3Dinteractive" pdfd=
ocs
>>=20
>> With that, LaTeX will stop at the offending line from the .tex file.
>>=20
>> On a quick test here, I'm getting these at Fedora 35:
>>=20
>> 	(/usr/share/texlive/texmf-dist/tex/latex/l3packages/xtemplate/xtempla=
te.sty)
>>=20
>> 	! LaTeX Error: File `ctexhook.sty' not found.
>>=20
>> 	Type X to quit or <RETURN> to proceed,
>> 	or enter new name. (Default extension: sty)
>>=20
>> It seems that a recent change (probably to better address issues with =

>> Chinese and Japanese translation) added an extra dependency to some
>> stylesheet.
>>=20
>> I solved it by installing this package: "texlive-ctex".
>=20
> 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:
>=20
> (/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=E2=80=
=99s\ETC.
> ! File ended while scanning use of \@writefile.
> <inserted text>=20
>                 \par=20
> l.191 \begin{document}
>=20
> ?=20

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=3DRCU LATEXOPTS=3D"-interaction=3Dinteractive" pdfd=
ocs

?

        Thanks, Akira