Re: [PATCH] <linux/rculist.h>: fix kernel-doc notation & warning

From: Eric W. Biederman
Date: Mon Jun 15 2020 - 12:03:01 EST


Randy Dunlap <rdunlap@xxxxxxxxxxxxx> writes:

> From: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
>
> Fix a kernel-doc warning due to missing a beginning '*' on the
> comment line.
>
> ../include/linux/rculist.h:515: warning: bad line: [@right ][node2 ... ]
>

Acked-by: "Eric W. Biederman" <ebiederm@xxxxxxxxxxxx>

> Fixes: 35fc0e3b0bd5 ("rculist: Add hlists_swap_heads_rcu")
> Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> Cc: Eric W. Biederman <ebiederm@xxxxxxxxxxxx>
> Cc: rcu@xxxxxxxxxxxxxxx
> ---
> include/linux/rculist.h | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> --- lnx-58-rc1.orig/include/linux/rculist.h
> +++ lnx-58-rc1/include/linux/rculist.h
> @@ -512,7 +512,7 @@ static inline void hlist_replace_rcu(str
> * @right: The hlist head on the right
> *
> * The lists start out as [@left ][node1 ... ] and
> - [@right ][node2 ... ]
> + * [@right ][node2 ... ]
> * The lists end up as [@left ][node2 ... ]
> * [@right ][node1 ... ]
> */