Re: [B.A.T.M.A.N.] [PATCH 1/7] batman-adv: remove useless inline attribute for sysfs helper function

Sven Eckelmann
2016-05-06T07:53:26Z

[-- Attachment #1: Type: text/plain, Size: 942 bytes --]

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

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 819 bytes --]