Subject: Re: [PATCH 8/9] bitfield: Add comment block for the host/fixed endian functions

From: David Laight <[email-masked]>
Date: Wed, 10 Dec 2025 10:08:46 +0000

On Wed, 10 Dec 2025 18:23:00 +0900
Jakub Kicinski <[email-masked]> wrote:

> On Tue,  9 Dec 2025 10:03:12 +0000 [email-masked] wrote:
> > + * * u32 le32_get_bits(__le32 val, u32 field) extracts the contents of the
> > + *   bitfield specified by @field in little-endian 32bit object @val and
> > + *   converts it to host-endian.  
> 
> possibly also add declarations for these? So that ctags and co. sees
> them?

The functions are bulk-generated using a #define, ctags is never going to
find definitions.

Adding kerneldoc comments is also painful.
I don't think it lets you use a single comment for multiple functions.

	David