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. Missing: automated check qdev-doc.json matches the code. Keeping the docs far from the code is a bad idea even with such a check. [...]
