Commit 1ede77df authored by Marc-André Lureau's avatar Marc-André Lureau Committed by Markus Armbruster
Browse files

qapi2texi: replace quotation by bold section name 



When we build qemu-qmp-ref.txt this causes texinfo to complain several
times:
"Negative repeat count does nothing at
/usr/share/texinfo/Texinfo/Convert/Line.pm line 124."

It also doesn't display correctly, because the "Notes" text disappears
entirely in the HTML version because it thinks there's no actual
quotation text.

The text file output formatting is also not good.

To solve those problems, remove usage of @quotation, and simply use bold
face for the section name.

Reported-by: default avatarPeter Maydell <peter.maydell@linaro.org>
Signed-off-by: default avatarMarc-André Lureau <marcandre.lureau@redhat.com>
Message-Id: <20170217093416.27688-1-marcandre.lureau@redhat.com>
Reviewed-by: default avatarMarkus Armbruster <armbru@redhat.com>
Signed-off-by: default avatarMarkus Armbruster <armbru@redhat.com>
parent d514cfd7

scripts/qapi2texi.py

+4 −6
Original line number Diff line number Diff line
@@ -159,11 +159,9 @@ def texi_body(doc): 
            func = texi_example



        if name:

            # FIXME the indentation produced by @quotation in .txt and

            # .html output is confusing

            body += "\n@quotation %s\n%s\n@end quotation" % \

                    (name, func(doc))

        else:

            # prefer @b over @strong, so txt doesn't translate it to *Foo:*

            body += "\n\n@b{%s:}\n" % name



        body += func(doc)



    return body