[PATCH] dts: fix API doc build warnings

Thomas Monjalon thomas at monjalon.net
Wed Nov 20 16:05:35 CET 2024


20/11/2024 15:41, Luca Vizzarro:
> Sphinx-autodoc issues warnings about some symbols due to bad autodoc
> "automock"ing when optional dependencies are missing.
> 
> The current meson setup allows to treat warnings as errors, halting the
> process and exiting early. Given these warnings should be ignored, this
> patch removes this behavior.

So the patch is not fixing warnings, it allows them.
I will change the title.

> Until optional dependencies are enforced,
> warnings for DTS API docs will be checked manually as part of the DTS
> approval process.

No, optional dependencies should never be enforced.

[...]
> -if get_option('werror')
> -    extra_sphinx_args += '-W'
> -endif





More information about the dev mailing list