OSDN Git Service

sphinx: qapidoc: Wrap "If" section body in a paragraph node
authorJohn Snow <jsnow@redhat.com>
Tue, 6 Apr 2021 14:19:09 +0000 (10:19 -0400)
committerPeter Maydell <peter.maydell@linaro.org>
Tue, 13 Apr 2021 09:14:58 +0000 (10:14 +0100)
commit2d18b4ca023ca1a3aee18064251d6e6e1084f3eb
tree9e6ca79efdff0776d237bc5a79bc772a7bc025dd
parent91c0a79891b080efea276caf6bd3ff10809c4e4c
sphinx: qapidoc: Wrap "If" section body in a paragraph node

These sections need to be wrapped in a block-level element, such as
Paragraph in order for them to be rendered into Texinfo correctly.

Before (e.g.):

<section ids="qapidoc-713">
  <title>If</title>
  <literal>defined(CONFIG_REPLICATION)</literal>
</section>

became:

  .SS If
  \fBdefined(CONFIG_REPLICATION)\fP.SS \fBBlockdevOptionsReplication\fP (Object)
  ...

After:

<section ids="qapidoc-713">
  <title>If</title>
  <paragraph>
    <literal>defined(CONFIG_REPLICATION)</literal>
  </paragraph>
</section>

becomes:

  .SS If
  .sp
  \fBdefined(CONFIG_REPLICATION)\fP
  .SS \fBBlockdevOptionsReplication\fP (Object)
  ...

Reported-by: Markus Armbruster <armbru@redhat.com>
Tested-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: John Snow <jsnow@redhat.com>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Message-id: 20210406141909.1992225-2-jsnow@redhat.com
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
docs/sphinx/qapidoc.py