2023-03-21 02:50:54

by Stephen Rothwell

[permalink] [raw]
Subject: linux-next: build warning after merge of the rcu tree

Hi all,

After merging the rcu tree, today's linux-next build (htmldocs) produced
this warning:

include/linux/srcu.h:106: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Annotations provide deadlock detection for SRCU.

Introduced by commit

57e98b73317b ("rcu: Annotate SRCU's update-side lockdep dependencies")

--
Cheers,
Stephen Rothwell


Attachments:
(No filename) (488.00 B)
OpenPGP digital signature

2023-03-21 03:01:51

by Boqun Feng

[permalink] [raw]
Subject: Re: linux-next: build warning after merge of the rcu tree

On Tue, Mar 21, 2023 at 01:50:47PM +1100, Stephen Rothwell wrote:
> Hi all,
>
> After merging the rcu tree, today's linux-next build (htmldocs) produced
> this warning:
>
> include/linux/srcu.h:106: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> * Annotations provide deadlock detection for SRCU.

Thanks for reporting. Fix it locally.

Regards,
Boqun

>
> Introduced by commit
>
> 57e98b73317b ("rcu: Annotate SRCU's update-side lockdep dependencies")
>
> --
> Cheers,
> Stephen Rothwell