diff options
author | Marc-André Lureau <marcandre.lureau@redhat.com> | 2017-02-17 13:34:16 +0400 |
---|---|---|
committer | Markus Armbruster <armbru@redhat.com> | 2017-02-20 14:10:46 +0100 |
commit | 1ede77dfd2220074c5ec3a1d1a25a5ec1ccbc17d (patch) | |
tree | 8e90a6ac01a16bd28417acafb0291d4002cab75f /scripts/qapi2texi.py | |
parent | d514cfd763b271b4e97a9fc6adaabc8fd50084ab (diff) | |
download | qemu-1ede77dfd2220074c5ec3a1d1a25a5ec1ccbc17d.zip qemu-1ede77dfd2220074c5ec3a1d1a25a5ec1ccbc17d.tar.gz qemu-1ede77dfd2220074c5ec3a1d1a25a5ec1ccbc17d.tar.bz2 |
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: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Message-Id: <20170217093416.27688-1-marcandre.lureau@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Diffstat (limited to 'scripts/qapi2texi.py')
-rwxr-xr-x | scripts/qapi2texi.py | 10 |
1 files changed, 4 insertions, 6 deletions
diff --git a/scripts/qapi2texi.py b/scripts/qapi2texi.py index 83ded95..c1071c6 100755 --- a/scripts/qapi2texi.py +++ b/scripts/qapi2texi.py @@ -159,12 +159,10 @@ 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: - body += func(doc) + # prefer @b over @strong, so txt doesn't translate it to *Foo:* + body += "\n\n@b{%s:}\n" % name + + body += func(doc) return body |