linux-kernel - Re: [PATCH] kernel/power: convert comment from kernel-doc to plain comment

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: <Z4Ju6JqtDxMmmv8Q@duo.ucw.cz>
Date: Sat, 11 Jan 2025 14:15:20 +0100
From: Pavel Machek <pavel@....cz>
To: Randy Dunlap <rdunlap@...radead.org>
Cc: linux-kernel@...r.kernel.org, "Rafael J. Wysocki" <rafael@...nel.org>,
	Len Brown <len.brown@...el.com>, linux-pm@...r.kernel.org
Subject: Re: [PATCH] kernel/power: convert comment from kernel-doc to plain
 comment

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@...radead.org>
> Cc: "Rafael J. Wysocki" <rafael@...nel.org>

Acked-by: Pavel Machek <pavel@....cz>

-- 
People of Russia, stop Putin before his war on Ukraine escalates.

Download attachment "signature.asc" of type "application/pgp-signature" (196 bytes)