linux-kernel - Re: [PATCH] powerpc/eeh_cache: fix a W=1 kernel-doc warning

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-Id: <45f3Mq1Jzfz9s8m@ozlabs.org>
Date:   Thu,  4 Jul 2019 00:27:02 +1000 (AEST)
From:   Michael Ellerman <patch-notifications@...erman.id.au>
To:     Qian Cai <cai@....pw>
Cc:     Qian Cai <cai@....pw>, sbobroff@...ux.ibm.com,
        linux-kernel@...r.kernel.org, oohall@...il.com, paulus@...ba.org,
        linuxppc-dev@...ts.ozlabs.org
Subject: Re: [PATCH] powerpc/eeh_cache: fix a W=1 kernel-doc warning

On Wed, 2019-06-05 at 20:46:19 UTC, Qian Cai wrote:
> The opening comment mark "/**" is reserved for kernel-doc comments, so
> it will generate a warning with "make W=1".
> 
> arch/powerpc/kernel/eeh_cache.c:37: warning: cannot understand function
> prototype: 'struct pci_io_addr_range
> 
> Since this is not a kernel-doc for the struct below, but rather an
> overview of this source eeh_cache.c, just use the free-form comments
> kernel-doc syntax instead.
> 
> Signed-off-by: Qian Cai <cai@....pw>
> Acked-by: Russell Currey <ruscur@...sell.cc>

Applied to powerpc next, thanks.

https://git.kernel.org/powerpc/c/3becd11dffe5d4a7467ebd841172f3e091fbcbd0

cheers