Re: [PATCH 06/15] qapi: Require member documentation (with loophole)

2024-02-12 Thread Markus Armbruster
Daniel P. Berrangé writes: > On Mon, Feb 05, 2024 at 08:47:00AM +0100, Markus Armbruster wrote: >> The QAPI generator forces you to document your stuff. Except for >> command arguments, event data, and members of enum and object types: >> these the generator silently "documents" as "Not

Re: [PATCH 06/15] qapi: Require member documentation (with loophole)

2024-02-07 Thread Daniel P . Berrangé
On Mon, Feb 05, 2024 at 08:47:00AM +0100, Markus Armbruster wrote: > The QAPI generator forces you to document your stuff. Except for > command arguments, event data, and members of enum and object types: > these the generator silently "documents" as "Not documented". > > We can't require proper

[PATCH 06/15] qapi: Require member documentation (with loophole)

2024-02-04 Thread Markus Armbruster
The QAPI generator forces you to document your stuff. Except for command arguments, event data, and members of enum and object types: these the generator silently "documents" as "Not documented". We can't require proper documentation there without first fixing all the offenders. We've always