Bug: PDF documentation doesn't build according to instructions

Bug: PDF documentation doesn't build according to instructions

[Patrick Walton]

[-- Attachment #1: Type: text/plain, Size: 609 bytes --]

When I follow the instructions for building PDF documentation ( https://docs.u-boot.org/en/latest/build/documentation.html ) , I run into an error at the texi2pdf step (attached). It appears to have to do with the boot flow diagram of k3_current not being an acceptable format for the pdf compiler. I tested this on several releases and it appears to have appeared in the v2023.10 release and continues to the latest. I was able to build the documentation on the v2023.07 release.

Take care,

Patrick Walton
Co-founder/CEO
Care Weather
801-227-4740
www.careweather.com ( http://www.careweather.com )

[-- Attachment #2: doc_error.txt --]
[-- Type: text/plain, Size: 1437 bytes --]

./doc/output/texinfo/u-boot.texi:119130: Could not find image file u-boot-figur
es/boot_diagram_k3_current for pdf.
@dopdfimage ...uld not find image file #1 for pdf}
                                                  @else @gdef @pdfimgext {JP...

@imagexxx ...t @fi @ifpdf @dopdfimage {#1}{#2}{#3}
                                                  @else @ifx @XeTeXrevision ...

@image ...true @fi @else @imagexxx #1,,,,,@finish 
                                                  @fi 
l.119130 ...am_k3_current,,,Boot flow diagram,svg}
                                                  
? 
./doc/output/texinfo/u-boot.texi:119130: Emergency stop.
@dopdfimage ...uld not find image file #1 for pdf}
                                                  @else @gdef @pdfimgext {JP...

@imagexxx ...t @fi @ifpdf @dopdfimage {#1}{#2}{#3}
                                                  @else @ifx @XeTeXrevision ...

@image ...true @fi @else @imagexxx #1,,,,,@finish 
                                                  @fi 
l.119130 ...am_k3_current,,,Boot flow diagram,svg}
                                                  
@Texinfo supports .png, .jpg, .jpeg, and .pdf images with PDF output, and none 
of those formats could be found. (.eps cannot be supported due to the design of
 the PDF format; use regular TeX (DVI output) for that.) 

./doc/output/texinfo/u-boot.texi:119130:  ==> Fatal error occurred, no output P
DF file produced!

Re: Bug: PDF documentation doesn't build according to instructions

[Tom Rini]

[-- Attachment #1: Type: text/plain, Size: 800 bytes --]

On Thu, Feb 08, 2024 at 12:17:56AM +0000, Patrick Walton wrote:

> When I follow the instructions for building PDF documentation (
> https://docs.u-boot.org/en/latest/build/documentation.html ) , I run
> into an error at the texi2pdf step (attached). It appears to have to
> do with the boot flow diagram of k3_current not being an acceptable
> format for the pdf compiler. I tested this on several releases and it
> appears to have appeared in the v2023.10 release and continues to the
> latest. I was able to build the documentation on the v2023.07 release.

Unfortunately PDF docs are not part of CI and it seems that we would
need a bit of work to make it automatically build as well. Patches to do
this as well as fix the problem you reported would be much appreciated.

-- 
Tom

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 659 bytes --]