linux-kernel - Re: [PATCH 3/3] firmware: stratix10-svc: fix make htmldocs 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: <2025112446-map-winter-7818@gregkh>
Date: Mon, 24 Nov 2025 17:49:04 +0100
From: Greg KH <gregkh@...uxfoundation.org>
To: Dinh Nguyen <dinguyen@...nel.org>
Cc: linux-kernel@...r.kernel.org, arnd@...db.de,
	Stephen Rothwell <sfr@...b.auug.org.au>
Subject: Re: [PATCH 3/3] firmware: stratix10-svc: fix make htmldocs warning

On Fri, Nov 14, 2025 at 12:58:15PM -0600, Dinh Nguyen wrote:
> Stephen Rothwell reports htmldocs warnings when merging char-misc tree:
> 
> WARNING: include/linux/firmware/intel/stratix10-svc-client.h:22 This comment
> starts with '/**', but isn't a kernel-doc comment.
> 
> WARNING: include/linux/firmware/intel/stratix10-svc-client.h:184 Enum value
> 'COMMAND_HWMON_READTEMP' not described in enum 'stratix10_svc_command_code'
> 
> WARNING: include/linux/firmware/intel/stratix10-svc-client.h:184 Enum value
> 'COMMAND_HWMON_READVOLT' not described in enum 'stratix10_svc_command_code'
> 
> WARNING: include/linux/firmware/intel/stratix10-svc-client.h:307 function
> parameter 'cb_arg' not described in 'async_callback_t'
> 
> Fixes: 4f49088c1625 ("firmware: stratix10-svc: Add definition for voltage and temperature sensor")
> Reported-by: Stephen Rothwell <sfr@...b.auug.org.au>
> Closes: https://lore.kernel.org/linux-next/20251114153920.1c5df700@canb.auug.org.au/
> Signed-off-by: Dinh Nguyen <dinguyen@...nel.org>
> ---
>  include/linux/firmware/intel/stratix10-svc-client.h | 10 ++++++++--
>  1 file changed, 8 insertions(+), 2 deletions(-)

This is the same subject line as patch 1/3.  Please don't do that.  I'll
try to fix this up...

thanks,

greg k-h