Markus Armbruster dcdc07a97c qapi: Make section headings start a new doc comment block
Our current QAPI doc-comment markup allows section headers (introduced
with a leading '=' or '==') anywhere in a free-form documentation
comment.  This works for Texinfo because the generator simply prints a
Texinfo section command at that point in the output stream.  For rST
generation, since we're assembling a tree of docutils nodes, this is
awkward because a new section implies starting a new section node at
the top level of the tree and generating text into there.

Make section headers start a new free-form documentation block, so the
future rST document generator doesn't have to look at every line in
free-form blocks and handle headings in odd places.

This change makes no difference to the generated Texinfo.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-Id: <20200320091805.5585-3-armbru@redhat.com>
2020-09-07 16:35:16 +02:00
..
2020-08-03 08:28:08 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2015-05-05 18:39:01 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2015-05-05 18:39:01 +02:00
2019-10-22 09:26:12 +02:00
2015-05-05 18:39:01 +02:00
2019-10-22 09:26:12 +02:00
2017-01-16 10:10:35 +01:00
2017-01-16 10:10:35 +01:00
2017-01-16 10:10:35 +01:00
2017-01-16 10:10:35 +01:00
2020-08-03 08:28:08 +02:00
2017-01-16 10:10:35 +01:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2015-05-05 18:39:01 +02:00
2015-05-05 18:39:00 +02:00
2015-05-05 18:39:00 +02:00
2015-05-05 18:39:01 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2020-08-21 06:30:15 -04:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2019-10-22 09:26:12 +02:00
2020-08-03 08:28:08 +02:00
2019-10-22 09:26:12 +02:00