Re: [Qemu-devel] Introducing GSoC project: API Documentation Generation

[Peter Maydell]

On Tue, 21 May 2019 at 16:18, Markus Armbruster <address@hidden> wrote:
> Anyway.  What's so special about QEMU that justifies coming up with our
> own doc syntax?  Other than "we made a hash of it, and cleaning it up
> would be work".

The major problem as far as kernel-doc is concerned is that
it somewhat bakes in the kernel's style choice that the
'struct' keyword is not hidden behind typedefs, and so it
gets a bit confused by QEMU's "use typedefs for struct types"
style. The rest, as you say, is just a matter of fixing up
our syntax errors.

thanks
-- PMM