On Friday 06 May 2016 09:23:40 Sven Eckelmann wrote: [...]
Kerneldoc cannot parse these kind of substructures. Just run:
scripts/kernel-doc -html net/batman-adv/types.h > test.html chromium test.html
It just creates random noise from your kerneldoc input. So one way to deal with it is to create a substruct hacks parse functionality for kerneldoc or avoid these kind of anonymous-type substructs and use extra correctly typed structs.
You can contact Jonathan Corbet and inform him that these kinds of things are not "correctly" parsed (and don't use dirty hacks to creat kerneldoc-sections like struct sockaddr_caif used for its union kerneldoc). Maybe with a small example.
From https://www.kernel.org/doc/Documentation/kernel-doc-nano-HOWTO.txt
Nesting of declarations is not supported.
So you either have to add it to kernel-doc or do it differently.
Kind regards, Sven