[PATCH v2 0/7] doc: make pdfdocs: Address issues with the make pdfdocs target

[Heinrich Schuchardt]

On 10/6/25 00:10, Adriano Carvalho wrote:
> This patch series address several issues that were affecting the make
> pdfdocs target.
> 
> In the end, the make pdfdocs could be considered fixed. It is at least
> with docker.io/trini/u-boot-gitlab-ci-runner:jammy-20250714-25Jul2025.
> 
> The thing is fixed only after the 6th commit. Each commit solves one
> issue, in the order as they appeared. I hope it makes sense.

Thanks for investigating the build failure.

The output seems to be separate pdfs usage.pdf, develop.pdf, ... .
Does this really make sense?

I still wonder if anybody ever would use such pdf files when he can have 
HTML documentation. Maybe you could use the files when dealing with a 
regulatory authority.

Best regards

Heinrich

> 
> Changes from v1:
> - Use already in place kfigure sphinx extension instead of
>    sphinxcontrib.inkscapeconverter.
> - I have kept the dependency on inkscape because: (1) ImageMagick's
>    convert fails to the job, and (2) it's what's done in the Linux kernel
>    on which kfigure is based.
> 
> Signed-off-by: Adriano Carvalho <adrianocarvalho.pt at gmail.com>
> 
> Adriano Carvalho (7):
>    doc: make pdfdocs: Specify texlive-xetex as a prerequisite
>    doc: make pdfdocs: Update the description with the needed steps
>    doc: make pdfdocs: Add pip install -r test/py/requirements.txt to the
>      list of needed steps
>    doc: make pdfdocs: Ensure SVG files are converted to PDF before the
>      compilation of *.tex files
>    doc: make pdfdocs: Update kfigure sphinx extension to support inkscape
>      as well
>    doc: make pdfdocs: Increase the maximum list depth
>    doc: make pdfdocs: Remove redundant "-j" option
> 
>   doc/Makefile                              |   1 -
>   doc/board/beagle/am62x_beagleplay.rst     |   8 +-
>   doc/board/beagle/am67a_beagley_ai.rst     |   6 +-
>   doc/board/beagle/j721e_beagleboneai64.rst |  10 +-
>   doc/board/samsung/e850-96.rst             |   2 +-
>   doc/board/ti/am62ax_sk.rst                |   6 +-
>   doc/board/ti/am62px_sk.rst                |   8 +-
>   doc/board/ti/am62x_sk.rst                 |   8 +-
>   doc/board/ti/am64x_evm.rst                |   8 +-
>   doc/board/ti/am65x_evm.rst                |  12 +-
>   doc/board/ti/j7200_evm.rst                |  10 +-
>   doc/board/ti/j721e_evm.rst                |  10 +-
>   doc/board/ti/j721s2_evm.rst               |   6 +-
>   doc/board/ti/j722s_evm.rst                |   6 +-
>   doc/board/ti/j784s4_evm.rst               |   8 +-
>   doc/board/ti/k3.rst                       |   8 +-
>   doc/build/documentation.rst               |  28 ++-
>   doc/conf.py                               |   4 +
>   doc/develop/memory.rst                    |   4 +-
>   doc/develop/trace.rst                     |  10 +-
>   doc/sphinx/kfigure.py                     | 212 ++++++++++++++++------
>   tools/docker/Dockerfile                   |   2 +
>   tools/patman/patman.rst                   |   2 +-
>   23 files changed, 252 insertions(+), 127 deletions(-)