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

[Markus Armbruster]

[note cc: Amit]

Gerd Hoffmann <address@hidden> writes:

>   Hi,
>
>> Some additional docs (based on 2/2 hints) might be a useful addition.
>
> Indeed.
>
>> Possible candidates:
>> - docs/qdev-device-use.txt
>> - qemu-doc.texi
>
> Hmm.
>
> qemu-doc.texi only documents the pre-qdev way to create devices.
> qdev-device-use.txt is a conversion guide.
>
> devices which can only be created via -device (or provide additional
> features via qdev attributes when created that way) are not documented
> anywhere now.
>
> Suggestions?  Should we add a qdev section to qemu-doc.texi?  Or
> better a separate qemu-devices.txt (or .texi)?
>
> What is the status of the qdev documentation patches btw.?

http://lists.gnu.org/archive/html/qemu-devel/2011-02/msg02169.html

>                                                             Maybe we
> should just merge them, then start filling stuff and maybe also
> autogenerate documentation from that?

Yes.

Amit, once more into the breach?