Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.)

[Anthony Liguori]

On 05/12/2011 10:25 AM, Gerd Hoffmann wrote:
> Hi,
>
> > > What is the status of the qdev documentation patches btw.?
> >
> > http://lists.gnu.org/archive/html/qemu-devel/2011-02/msg02169.html
>
> What is the problem with the empty strings btw?
>
> The only way around I can see is having _DOC and _NODOC versions for all
> the property macros, but I'd prefer to not have _NODOC macros in the
> tree ...

Inline documentation is bad.  Our documentation should be centralized. 
 That's the only way to keep it consistent and thorough.

There's no way to easily extract the inline docs in a complete way since 
some devices are built conditionally.

Regards,

Anthony Liguori

> cheers,
> Gerd