On 21-10-16 15:01, Johannes Berg wrote:

On Fri, 2016-10-21 at 15:57 +0300, Jani Nikula wrote:

quoted

It's easier to manage the kernel-doc for the fields when they
documentation is next to the field.

Hah, I wasn't even aware this was possible. Thanks!

Me neither. I actually found it annoying to have all kernel-doc above
the type definition and indeed easy to miss fields. Now struct
ieee80211_hw is not alone and we have it all over the place in the
wireless subsystem. Is this something we want to embrace and maybe find
janitors/newbies/coccinelle-gurus to address it. Not sure if coccinelle
could deal with this.

Regards,
Arend