PATCH 1 fixes an old defect in the doc comment parser. I figure it'll simplify the rST generator's job.
PATCH 2 might simplify it further. It's RFC because I'm not sure it does. Peter, you tell me :) Markus Armbruster (2): qapi: Reject section markup in definition documentation [RFC] qapi: Make section headings start a new doc comment block docs/devel/qapi-code-gen.txt | 2 ++ scripts/qapi/parser.py | 24 +++++++++++++++++------- tests/qapi-schema/doc-bad-section.err | 1 + tests/qapi-schema/doc-bad-section.json | 3 +-- tests/qapi-schema/doc-bad-section.out | 24 ------------------------ tests/qapi-schema/doc-good.out | 3 ++- 6 files changed, 23 insertions(+), 34 deletions(-) -- 2.21.1