Hi Bohdan,

Yes, the -W option (treating warnings as errors) was added intentionally to ensure clean, warning-free documentation builds, so ideally we should aim to fix all issues.

With the introduction of intersphinx, some reference-related warnings have become more difficult to resolve, especially when they involve links to other repositories or mismatched versions.

You may have noticed that the online documentation was building successfully until recently—this is because ReadTheDocs does not use the -W option by default. However, it broke today due to a separate issue.

I'll investigate these problems and follow up once I have more information.

Best regards,
Anton

From: Bohdan.Hunko--- via TF-M <tf-m@lists.trustedfirmware.org>
Sent: Friday, May 30, 2025 8:32 AM
To: tf-m@lists.trustedfirmware.org
Subject: [TF-M] Issue building docs

Hi all,

I am trying to build docs with following commands:

cmake -S docs -B ./build_docs

cmake --build build_docs/ -- tfm_docs_userguide_pdf

But I get following error

resolving references...

failed

Warning, treated as error:

RSVG converter command 'rsvg-convert' cannot be run. Check the rsvg_converter_bin setting

When I remove -W (warnings are errors) option from

COMMAND "${SPHINX_EXECUTABLE}" -W -b html -j 1 -c ${SPHINXCFG_CONFIG_PATH} ${SPHINXCFG_SOURCE_PATH} "${SPHINXCFG_OUTPUT_PATH}/html"

In docs/CMakeLists.txt then docs builds fine.

Is this -W option intentional? Should this issue be fixed or -W removed?

Regards,

Bohdan Hunko

Cypress Semiconductor Ukraine

Engineer

CSUKR CSS ICW SW FW

Mobile: +38099 50 19 714
Bohdan.Hunko@infineon.com