Missing UTHREAD doc annotations

[Tom Rini]

On Tue, Apr 29, 2025 at 12:16:03PM +0200, Jerome Forissier wrote:
> 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.

Ah good, thanks.

> > 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.

Yes, I feel like there must be a bug there and so that's part of why I
cc'd Heinrich.

-- 
Tom
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 659 bytes
Desc: not available
URL: <https://lists.denx.de/pipermail/u-boot/attachments/20250429/5b07809b/attachment.sig>