On Fri, 27 Feb 2026 at 12:10, Markus Armbruster <[email protected]> wrote: > The larger problem is that we generally fail at documenting device and > machine properties. I'm not asking you to boil that ocean :) > > The narrow problem is providing guidance on watchdog configuration. > What and where? > > Regarding where: you proposed to add a machine property of QAPI enum > type. > > The property can have a description, and you give it one. Sadly, it's > basically invisible. As far as I know, the only way you can get at it > is qom-list-properties and such. I doubt anybody is going to read the > description there.
I think it also will appear if you run e.g. qemu-system-arm -M virt,help (which produces a list of all properties with their short descriptions) For board-specific properties, we should be documenting these in the manual page for the board. For instance "virt" does that here: https://www.qemu.org/docs/master/system/arm/virt.html#machine-specific-options For the global machine options, I don't think we have a place where we document those. If we did, we should perhaps have each board's page also link to the global-options page. -- PMM
