summary refs log tree commit diff stats
path: root/scripts/qapi-event.py
diff options
context:
space:
mode:
authorMarkus Armbruster <armbru@redhat.com>2017-08-24 21:13:53 +0200
committerMarkus Armbruster <armbru@redhat.com>2017-09-04 13:09:12 +0200
commit211e5063be7ffc34ed1daaa4a1aa5f5cfb039995 (patch)
treea8cf84e8b53617444621e2939e19c465581cc7c4 /scripts/qapi-event.py
parentcbb654052600c376d5ee3401c98a25d09d11a154 (diff)
downloadfocaccia-qemu-211e5063be7ffc34ed1daaa4a1aa5f5cfb039995.tar.gz
focaccia-qemu-211e5063be7ffc34ed1daaa4a1aa5f5cfb039995.zip
qapi-schema: Document how generated documentation is ordered
Documentation generated with qapi2texi.py is in source order, with
included sub-schemas inserted at the first include directive
(subsequent include directives have no effect).  To get a sane and
stable order, it's best to include each sub-schema just once, or
include it first in qapi-schema.json.  Document that.

While there, drop a few redundant comments.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>
Message-Id: <1503602048-12268-2-git-send-email-armbru@redhat.com>
Diffstat (limited to 'scripts/qapi-event.py')
0 files changed, 0 insertions, 0 deletions