[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: p
From: |
Markus Armbruster |
Subject: |
Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.) |
Date: |
Thu, 12 May 2011 20:00:07 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux) |
Anthony Liguori <address@hidden> writes:
> On 05/12/2011 11:18 AM, Markus Armbruster wrote:
>> Anthony Liguori<address@hidden> writes:
>>
>>> 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 ...
>>>
>>> Here's an example of what I'm suggesting. I think we should just go
>>> with this and add better output as we go.
>>>
>>> But we need all of the qdev information.. not just a doc string for
>>> each property.
>>
>> Missing: make "device_add ?" show your device doc strings, and
>> "device_add NAME,?" show your property doc strings.
>
> I really dislike overloading things for inline help. Introducing a
> device_help is fine and hopefully you realize that generating this is
> trivial.
I never liked "device_add ?" myself, but it's what we got. I'd support
replacing it with something more decent.
[...]
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.), (continued)
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.), Markus Armbruster, 2011/05/13
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.), Markus Armbruster, 2011/05/12
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.), Anthony Liguori, 2011/05/12
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.), Anthony Liguori, 2011/05/12
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.), Markus Armbruster, 2011/05/12
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.), Anthony Liguori, 2011/05/12
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.),
Markus Armbruster <=
- Re: [Qemu-devel] qdev device documentation (Re: [PATCH 0/2] usb-linux: physical port handling.), Anthony Liguori, 2011/05/12