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

From: David Laight
Date: Wed Dec 10 2025 - 05:09:08 EST


On Wed, 10 Dec 2025 18:23:00 +0900
Jakub Kicinski <kuba@xxxxxxxxxx> wrote:

> On Tue, 9 Dec 2025 10:03:12 +0000 david.laight.linux@xxxxxxxxx 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