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

[Adriano Carvalho]

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.

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(-)

-- 
2.34.1