Re: [Qemu-devel] [PATCH v2 1/4] memory: make memory API parsable by gtkdoc-scan (v2)

[Anthony Liguori]

On 12/15/2011 03:28 AM, Kevin Wolf wrote:
> Am 14.12.2011 21:01, schrieb Anthony Liguori:
> > gtkdoc-scan cannot handle nested structs so remove those from the memory API.
> >
> > Signed-off-by: Anthony Liguori<address@hidden>
>
> Surely the right thing to do then is fixing gtkdoc-scan?

It's not quite that simple.  gtkdoc uses a documentation format of:

 Thing

 Longer description of thing

  - sub-bullets about things parameters and/or members
  - another sub-bullet about things parameters and/or members.

So it's expecting to deal with only one level of nesting.  You would have to 
make significant changes to deal with multiple levels of nesting.

That said, I think using an anonymous named structure for grouping is a bit 
dubious to begin with.

Regards,

Anthony Liguori

> Kevin