Subject: Re: [PATCH] gpio: Fix kernel-doc comments to nested union

From: Stephen Rothwell <[email-masked]>
Date: Mon, 6 Jun 2022 15:48:54 +1000

Hi Akira,

On Mon, 6 Jun 2022 13:44:24 +0900 Akira Yokosawa <[email-masked]> wrote:
>
> Commit 48ec13d36d3f ("gpio: Properly document parent data union")
> is supposed to have fixed a warning from "make htmldocs" regarding
> kernel-doc comments to union members.  However, the same warning
> still remains [1].
> 
> Fix the issue by following the example found in section "Nested
> structs/unions" of Documentation/doc-guide/kernel-doc.rst.
> 
> Signed-off-by: Akira Yokosawa <[email-masked]>
> Reported-by: Stephen Rothwell <[email-masked]>
> Fixes: 48ec13d36d3f ("gpio: Properly document parent data union")
> Link: https://lore.kernel.org/r/[email-masked]/ [1]
> Cc: Linus Walleij <[email-masked]>
> Cc: Bartosz Golaszewski <[email-masked]>
> Cc: Joey Gouly <[email-masked]>
> Cc: Marc Zyngier <[email-masked]>
> ---
>  include/linux/gpio/driver.h | 29 ++++++++++++++++-------------
>  1 file changed, 16 insertions(+), 13 deletions(-)

Looks good, thanks.

Tested-by: Stephen Rothwell <[email-masked]>

-- 
Cheers,
Stephen Rothwell