summaryrefslogtreecommitdiff
path: root/scripts/qapi2texi.py
diff options
context:
space:
mode:
authorMarkus Armbruster <armbru@redhat.com>2018-02-11 10:35:40 +0100
committerEric Blake <eblake@redhat.com>2018-03-02 13:14:08 -0600
commitc263de3f419be945499ff7e6bd7512702f8bd522 (patch)
tree29e6fa4f4bec7b97c199616d34a1228de95514bc /scripts/qapi2texi.py
parent0dd13589b0dc1d91bb1281a0d10ddaa71b8b5ccd (diff)
downloadqemu-c263de3f419be945499ff7e6bd7512702f8bd522.tar.gz
qapi: Streamline boilerplate comment generation
Every generator has separate boilerplate for .h and .c, and their differences are boring. All of them repeat the license note. Reduce the repetition as follows. Move common text like the license note to common open_output(), next to the existing common text there. For each generator, replace the two separate descriptions by a single one. While there, emit an "automatically generated" note into generated documentation, too. Signed-off-by: Markus Armbruster <armbru@redhat.com> Reviewed-by: Eric Blake <eblake@redhat.com> Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com> Message-Id: <20180211093607.27351-3-armbru@redhat.com> Signed-off-by: Eric Blake <eblake@redhat.com>
Diffstat (limited to 'scripts/qapi2texi.py')
-rwxr-xr-xscripts/qapi2texi.py3
1 files changed, 2 insertions, 1 deletions
diff --git a/scripts/qapi2texi.py b/scripts/qapi2texi.py
index bf1c57b2e2..8a604d86a6 100755
--- a/scripts/qapi2texi.py
+++ b/scripts/qapi2texi.py
@@ -283,7 +283,8 @@ def main(argv):
print("%s: need pragma 'doc-required' "
"to generate documentation" % argv[0], file=sys.stderr)
sys.exit(1)
- print(texi_schema(schema))
+ print('@c AUTOMATICALLY GENERATED, DO NOT MODIFY\n')
+ print(texi_schema(schema), end='')
if __name__ == '__main__':