Re: [PATCH] MIPS: ath25: clean up non-kernel-doc comment warning
From: Sergey Ryazanov
Date: Tue Aug 23 2022 - 04:28:37 EST
On Tue, Aug 23, 2022 at 5:54 AM Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote:
> Don't use "/**" kernel-doc notation for comments that are not in
> kernel-doc format.
>
> Eliminates one warning:
>
> arch/mips/pci/pci-ar2315.c:6: warning: This comment starts with
> '/**', but isn't a kernel-doc comment. Refer
> Documentation/doc-guide/kernel-doc.rst
> * Both AR2315 and AR2316 chips have PCI interface unit, which supports DMA
>
> Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> Reported-by: kernel test robot <lkp@xxxxxxxxx>
> Cc: Aditya Srivastava <yashsri421@xxxxxxxxx>
> Cc: Thomas Bogendoerfer <tsbogend@xxxxxxxxxxxxxxxx>
> Cc: linux-mips@xxxxxxxxxxxxxxx
> Cc: Sergey Ryazanov <ryazanov.s.a@xxxxxxxxx>
> ---
> Fixes: 3ed7a2a702dc ("MIPS: ath25: add AR2315 PCI host controller driver")
> but backport is not needed.
Acked-by: Sergey Ryazanov <ryazanov.s.a@xxxxxxxxx>
Randy, Bagas, which one of these patches should be applied:
* https://patchwork.kernel.org/project/linux-mips/patch/20220823030056.123709-1-bagasdotme@xxxxxxxxx/
* https://patchwork.kernel.org/project/linux-mips/patch/20220823025441.30708-1-rdunlap@xxxxxxxxxxxxx/