Re: [PATCH] mailbox: hi3660: convert struct comments to kernel-doc notation

From: Leo Yan
Date: Mon Nov 15 2021 - 08:12:05 EST


On Sun, Nov 14, 2021 at 07:31:19PM -0800, Randy Dunlap wrote:
> Convert hi3660 struct comments to kernel-doc notation and fix
> other kernel-doc warnings:
>
> drivers/mailbox/hi3660-mailbox.c:47: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> * Hi3660 mailbox channel information
> drivers/mailbox/hi3660-mailbox.c:62: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> * Hi3660 mailbox controller data
> hi3660-mailbox.c:53: warning: contents before sections
> hi3660-mailbox.c:67: warning: contents before sections
>
> Fixes: 41c0e939d70d ("mailbox: Add support for Hi3660 mailbox")
> Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> Reported-by: kernel test robot <lkp@xxxxxxxxx>
> Cc: Jassi Brar <jassisinghbrar@xxxxxxxxx>
> Cc: Leo Yan <leo.yan@xxxxxxxxxx>
> Cc: Ruyi Wang <wangruyi@xxxxxxxxxx>
> Cc: Kaihua Zhong <zhongkaihua@xxxxxxxxxx>

Thank you for fixing and improvment comments.

Reviewed-by: Leo Yan <leo.yan@xxxxxxxxxx>