Re: [Qemu-devel] KVM call minutes for Feb 8

[Markus Armbruster]

Peter Maydell <address@hidden> writes:

> On 9 February 2011 08:11, Markus Armbruster <address@hidden> wrote:
>> Peter Maydell <address@hidden> writes:
>>> Markus Armbruster <address@hidden> wrote:
>>>> I've said this before: at some point in time (sooner rather than
>>>>  later, if you ask me), we need to shoot the stragglers.
>
>>> ...and my question is: where is the documentation on how to do
>>> a good conversion of a device to qdev, how it works, what the
>>> assumptions you can/can't make are, etc ? I can't see anything
>>> relevant in the source tree or on the website, but maybe I'm just
>>> looking in the wrong places...
>>
>> Unfortunately, you're not.
>
> It seems to me that if you want the maintainers of the random
> oddball platforms and devices to do qdev conversion, this is
> much more likely to happen if it's clearly documented how to
> do it. Otherwise the only people who can do a good qdev
> conversion are the people who care about qdev and it has
> to be their responsibility to convert everybody over...

I regret the lack of proper qdev documentation as much as anyone.  For
what it's worth, the lone file on qdev in doc/ bears my fingerprints.
Still, it's difficult for me to second-guess the original designer.
Yes, it's quite fair to ask the folks calling for qdevification (read:
*me*) to support that with better documentation.  But I think it's also
fair to ask the man who designed qdev and has been so critical much of
its use (read: Paul) to provide a bit more guidance.

Paul, please?