Anthony Liguori <anth...@codemonkey.ws> writes: > On 05/12/2011 11:18 AM, Markus Armbruster wrote: >> Anthony Liguori<anth...@codemonkey.ws> 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. [...]
