linux-kernel - Re: [PATCH] dpll: zl3073x: fix kernel-doc name and missing parameter in fw.c

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] [thread-next>] [day] [month] [year] [list]

Message-ID: <CAL4kbRPWAfH6AXjsXtwugtpGaH-Omc3uNmtzacFOt1CUqNNWbg@mail.gmail.com>
Date: Wed, 12 Nov 2025 09:54:32 +0530
From: Kriish Sharma <kriish.sharma2006@...il.com>
To: Jakub Kicinski <kuba@...nel.org>
Cc: Ivan Vecera <ivecera@...hat.com>, Prathosh Satish <Prathosh.Satish@...rochip.com>, 
	Vadim Fedorenko <vadim.fedorenko@...ux.dev>, 
	Arkadiusz Kubalewski <arkadiusz.kubalewski@...el.com>, Jiri Pirko <jiri@...nulli.us>, 
	netdev@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] dpll: zl3073x: fix kernel-doc name and missing parameter
 in fw.c

On Wed, Nov 12, 2025 at 7:12 AM Jakub Kicinski <kuba@...nel.org> wrote:
> What do you mean by "documentation build"? make htmldocs?

Yes, I ran make htmldocs , which triggered the kernel-doc warnings.

> This now makes the kernel-doc script realize that the return value is
> not documented. Please also add a : after the Returns on the last line

Thanks for the review, Jakub.
I’ll add the missing colon after “Returns” in the kernel-doc comment
and send a v2 shortly.