On Tue, 6 Apr 2021 at 15:19, John Snow <js...@redhat.com> wrote: > > 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 <arm...@redhat.com> > Tested-by: Markus Armbruster <arm...@redhat.com> > Signed-off-by: John Snow <js...@redhat.com>
Reviewed-by: Peter Maydell <peter.mayd...@linaro.org> It's a shame Sphinx doesn't diagnose this kind of mis-constructed document tree. thanks -- PMM
