Re: [PATCH] kernel/power: convert comment from kernel-doc to plain comment
From: Rafael J. Wysocki
Date: Tue Jan 14 2025 - 15:16:17 EST
On Sat, Jan 11, 2025 at 2:15 PM Pavel Machek <pavel@xxxxxx> wrote:
>
> On Fri 2025-01-10 22:31:07, Randy Dunlap wrote:
> > Modify a non-kernel-doc comment to begin with /* instead of /**
> > so that it does not cause a kernel-doc warning.
> >
> > power.h:114: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
> > * Auxiliary structure used for reading the snapshot image data and
> > power.h:114: warning: missing initial short description on line:
> > * Auxiliary structure used for reading the snapshot image data and
> >
> > Signed-off-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> > Cc: "Rafael J. Wysocki" <rafael@xxxxxxxxxx>
>
> Acked-by: Pavel Machek <pavel@xxxxxx>
Applied as 6.14 material, thanks!