Missing UTHREAD doc annotations
Jerome Forissier
jerome.forissier at linaro.org
Tue Apr 29 12:16:03 CEST 2025
Hi Tom,
On 4/28/25 23:40, Tom Rini wrote:
> Hey,
>
> As part of manually building the docs before doing -rc1, I saw the
> following:
> ./include/uthread.h:56: warning: cannot understand function prototype:
> 'enum uthread_mutex_state '
> ./include/uthread.h:64: warning: cannot understand function prototype:
> 'struct uthread_mutex '
> ./include/uthread.h:56: warning: cannot understand function prototype:
> 'enum uthread_mutex_state '
> ./include/uthread.h:64: warning: cannot understand function prototype:
> 'struct uthread_mutex '
>
> Which should be fixed.
Please see https://lists.denx.de/pipermail/u-boot/2025-April/588263.html.
> I also noticed that with KDOC_WERROR=1 this did
> not fail and still produced an exit status of 0 which is why it was
> merged and not noticed until now.
That's unfortunate. I don't understand why warning don't stop the build
given that sphinx-build is given the -W option already.
--
Jerome
More information about the U-Boot
mailing list