[PATCH v2 1/7] doc: make pdfdocs: Specify texlive-xetex as a prerequisite

[E Shattow]

On 10/17/25 06:57, Heinrich Schuchardt wrote:
> On 10/6/25 00:10, Adriano Carvalho wrote:
>> Dockerfile updated as well.
>>
>> If I don't apt install texlive-xetex, this is what I get with
>> docker.io/trini/u-boot-gitlab-ci-runner:jammy-20250714-25Jul2025:
>>
>> uboot at 35c89b9ab70e:~/u-boot$ make pdfdocs
>>    HOSTCC  scripts/basic/fixdep
>> doc/Makefile:89: The 'xelatex' command was not found. Make sure you
>> have it installed and in PATH to produce PDF output.
>>    SKIP    Sphinx pdfdocs target.
>>
>> NOTE: This won't completely fix the pdfdocs target. See next commit(s).
>>
>> Signed-off-by: Adriano Carvalho <adrianocarvalho.pt at gmail.com>
>> Reviewed-by: Tom Rini <trini at konsulko.com>
>> ---
>>   doc/build/documentation.rst | 2 ++
>>   tools/docker/Dockerfile     | 1 +
>>   2 files changed, 3 insertions(+)
>>
>> diff --git a/doc/build/documentation.rst b/doc/build/documentation.rst
>> index b55a4666643..81548390d78 100644
>> --- a/doc/build/documentation.rst
>> +++ b/doc/build/documentation.rst
>> @@ -16,6 +16,8 @@ the following dependencies are needed to build the
>> documentation:
>>     * texinfo (if building the `Infodoc documentation`_)
>>   +* texlive-xetex (if building the `PDF documentation`_ through the
>> *pdfdocs* target)
>> +
>>   When submitting patches for documentation always build with
>> KDOC_WERROR=1 to
>>   treat warnings as errors.
>>   diff --git a/tools/docker/Dockerfile b/tools/docker/Dockerfile
>> index 5b4c75f8400..8e166eda4bc 100644
>> --- a/tools/docker/Dockerfile
>> +++ b/tools/docker/Dockerfile
>> @@ -136,6 +136,7 @@ RUN --mount=type=cache,target=/var/cache/
>> apt,sharing=locked \
>>       sudo \
>>       swig \
>>       texinfo \
>> +    texlive-xetex \
> 
> When I try to run `make pdfdocs` I see an error message
> 
>     ! LaTeX Error: File `xeCJK.sty' not found.
> 
> Why wouldn't you install package texlive-lang-cjk?
> 
> Best regards
> 
> Heinrich
> 
>>       util-linux \
>>       uuid-dev \
>>       vboot-kernel-utils \
> 

$ apt rdepends texlive-lang-cjk
texlive-lang-cjk
Reverse Depends:
  Breaks: texlive-xetex (<< 2021.20220204)
  Recommends: yatex
  Depends: texlive-lang-korean (>= 2024.20240401)
  Depends: texlive-lang-japanese (>= 2024.20240401)
  Depends: texlive-lang-chinese (>= 2024.20240401)
  Depends: texlive-lang-all (>= 2024.20240401)
  Conflicts: texlive-base (<< 2024.20240401)
  Depends: texlive-full (>= 2024.20240401)
  Suggests: sisu-complete
  Suggests: sisu-pdf

$ apt rdepends texlive-fonts-recommended
texlive-fonts-recommended
Reverse Depends:
  Breaks: texlive-base (<< 2019.20200213)
  Depends: wims
  Recommends: wiki2beamer
  Depends: tth-common
  Suggests: texstudio
  Depends: texmacs-texmf
  Depends: texlive-science (>= 2024.20240401)
  Recommends: texlive-latex-extra
  Depends: texlive-formats-extra (>= 2024.20240401)
  Recommends: texlive-fonts-extra
  Depends: texlive-full (>= 2024.20240401)
  Replaces: texlive-base (<< 2019.20200213)
  Depends: texlive (>= 2024.20240401)
  Conflicts: texlive-base (<< 2024.20240401)
  ...

Should that be texlive-full or possibly texlive-fonts-recommended ?

https://qa.debian.org/popcon.php?package=texlive-base

Package popularity by dkpg action:
texlive-base                    23153
texlive-latex-base              21623
texlive-latex-recommended       18692
texlive-fonts-recommended       17301
texlive-pictures                16209
texlive-luatex                  12072
texlive-metapost                 5498
texlive-xetex                    9345
texlive                          8392
texlive-full                     3513
texlive-fonts-recommended-doc    6340

Not texlive-full as this is much less likely to be installed. Maybe then
texlive instead of texlive-xetex.

-E