Re: [PATCH 5/5] docs/devel: introduce some key concepts for QOM development

2023-06-20 Thread Paolo Bonzini
On Mon, Jun 19, 2023 at 7:15 PM Alex Bennée wrote: > > Using QOM correctly is increasingly important to maintaining a modern > code base. However the current documentation skips some important > concepts before launching into a simple example. Lets: > > - at least mention properties > - mentio

Re: [PATCH 5/5] docs/devel: introduce some key concepts for QOM development

2023-06-20 Thread Richard Henderson
On 6/19/23 19:14, Alex Bennée wrote: +As class initialisation cannot fail devices have an two additional +methods to handle the creation of dynamic devices. The ``realize`` Beginning with "as" feels like a continuation from something that has been omitted. You've skipped over describing ``init

[PATCH 5/5] docs/devel: introduce some key concepts for QOM development

2023-06-19 Thread Alex Bennée
Using QOM correctly is increasingly important to maintaining a modern code base. However the current documentation skips some important concepts before launching into a simple example. Lets: - at least mention properties - mention TYPE_OBJECT and TYPE_DEVICE - talk about why we have realize/