qapi: Provide nicer array names in introspection
commitce5fcb472d512455a8d13fae4c04ecf8eb00573b
authorEric Blake <eblake@redhat.com>
Fri, 6 Nov 2015 06:35:35 +0000 (5 23:35 -0700)
committerMarkus Armbruster <armbru@redhat.com>
Tue, 10 Nov 2015 07:09:15 +0000 (10 08:09 +0100)
tree71d1d0564b9bbb7c773219b56aa1c7c3da6a1e5f
parent2533377c7b0c686d1510ed6499cedf938607e805
qapi: Provide nicer array names in introspection

For the sake of humans reading introspection output, it is nice
to have the name of implicit array types be recognizable as
arrays of the underlying type.  However, while this patch allows
humans to skip from a command with return type "[123]" straight
to the definition of type "123" without having to first inspect
type "[123]", document that this shortcut should not be taken by
client apps.

This makes the resulting introspection string slightly larger by
default (just over 200 bytes), but it's in the noise (less than
0.3% of the overall 70k size of 'query-qmp-capabilities').

Signed-off-by: Eric Blake <eblake@redhat.com>
Message-Id: <1446791754-23823-12-git-send-email-eblake@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
docs/qapi-code-gen.txt
scripts/qapi-introspect.py