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 <[email protected]>
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(-)
