On Tue, 6 Apr 2021 at 15:19, John Snow <[email protected]> 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 <[email protected]> > Tested-by: Markus Armbruster <[email protected]> > Signed-off-by: John Snow <[email protected]>
Reviewed-by: Peter Maydell <[email protected]> It's a shame Sphinx doesn't diagnose this kind of mis-constructed document tree. thanks -- PMM
