On Mon, Aug 25, 2025 at 11:44:45PM +0100, Adriano Carvalho wrote:

> It is not clear that before "make pdfdocs" it is also necessary to install 
> "doc/sphinx/requirements.txt".
> If I don't install "doc/sphinx/requirements.txt", this is what I get with 
> docker.io/trini/u-boot-gitlab-ci-runner:jammy-20250714-25Jul2025:
> 
> uboot@35c89b9ab70e:~/u-boot$ make pdfdocs
>   SPHINX  latexdocs --> file:///home/uboot/u-boot/doc/output/latex
>   PARSE   include/linker_lists.h
> Running Sphinx v4.3.2
> Warning: The Sphinx 'sphinx_rtd_theme' HTML theme was not found. Make sure 
> you have the theme installed to produce pretty HTML output. Falling back to 
> the default theme.
> loading translations [en]... done
> 
> Extension error:
> Could not import extension sphinx-prompt (exception: No module named 
> 'sphinx-prompt')
> make[1]: *** [doc/Makefile:84: latexdocs] Error 2
> make: *** [Makefile:2686: pdfdocs] Error 2
> 
> A "t" was also missing in "documenation". This commit fixes that also.
> NOTE: This won't completely fix the pdfdocs target. See next commit(s).

We should make it clear in the documentation on building the docs that
you need to do this for any build target.

-- 
Tom

Attachment: signature.asc
Description: PGP signature

Reply via email to