| commit | b116fd8e302d0ff7cabf431e78ce078127b51f85 | |
| author | Markus Armbruster <armbru@redhat.com> | |
| Wed, 15 Mar 2017 12:57:00 +0000 (15 13:57 +0100) | ||
| committer | Markus Armbruster <armbru@redhat.com> | |
| Thu, 16 Mar 2017 06:13:02 +0000 (16 07:13 +0100) | ||
| tree | 9ef95b8e68ce9ae58b0e079cc4e9adcb6cf932e9 | treesnapshot (tar.gz zip) |
| parent | 42bebcc129a8bf235f41d65788eb54e199ba5e64 | commitdiff |
qapi: Avoid unwanted blank lines in QAPIDoc
We silently fix missing #optional tags for QAPIDoc by appending a line
"#optional" to the section's .content. However, this interferes with
.__repr__ stripping trailing blank lines from .content.
Use new ArgSection instance variable .optional instead, and leave
.content alone.
To permit testing .optional in texi_body(), clean up texi_enum()'s
hack to add empty documentation for undocumented enum values: add an
ArgSection instead of ''.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Message-Id: <1489582656-31133-12-git-send-email-armbru@redhat.com>
We silently fix missing #optional tags for QAPIDoc by appending a line
"#optional" to the section's .content. However, this interferes with
.__repr__ stripping trailing blank lines from .content.
Use new ArgSection instance variable .optional instead, and leave
.content alone.
To permit testing .optional in texi_body(), clean up texi_enum()'s
hack to add empty documentation for undocumented enum values: add an
ArgSection instead of ''.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Message-Id: <1489582656-31133-12-git-send-email-armbru@redhat.com>
| scripts/qapi.py | diffblobblamehistory | |
| scripts/qapi2texi.py | diffblobblamehistory |