linux-kernel - Re: [PATCH] scatterlist: fix extraneous '@...ign kernel-doc notation

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: <aEEEySwOMEcBlbud@casper.infradead.org>
Date: Thu, 5 Jun 2025 03:45:29 +0100
From: Matthew Wilcox <willy@...radead.org>
To: Randy Dunlap <rdunlap@...radead.org>
Cc: linux-kernel@...r.kernel.org, Andrew Morton <akpm@...ux-foundation.org>,
	linux-doc@...r.kernel.org
Subject: Re: [PATCH] scatterlist: fix extraneous '@...ign kernel-doc notation

On Wed, Jun 04, 2025 at 05:23:37PM -0700, Randy Dunlap wrote:
> Using "@argname@" in kernel-doc produces "argname****" (with "argname"
> in bold) in the generated html output, so use the expected kernel-doc
> notation of just "@argname" instead.
> 
> "Fixes:" are added in case Matthew's patch [1] is backported.

Thanks!  I only skimmed the built docs and didn't notice this ... oddity.

> Fixes: 0db9299f48eb ("SG: Move functions to lib/scatterlist.c and add sg chaining allocator helpers")
> Fixes: 8d1d4b538bb1 ("scatterlist: inline sg_next()")
> Fixes: 18dabf473e15 ("Change table chaining layout")
> Signed-off-by: Randy Dunlap <rdunlap@...radead.org>
> Cc: Andrew Morton <akpm@...ux-foundation.org>
> Cc: Matthew Wilcox <willy@...radead.org>
> Cc: linux-doc@...r.kernel.org

Reviewed-by: Matthew Wilcox (Oracle) <willy@...radead.org>