docs/devel/qapi-code-gen: Rewrite compatibility considerations
commitab76bc279487ca248eb61f8d1ad9923a584e1370
authorMarkus Armbruster <armbru@redhat.com>
Fri, 13 Sep 2019 20:13:46 +0000 (13 22:13 +0200)
committerMarkus Armbruster <armbru@redhat.com>
Tue, 24 Sep 2019 12:07:22 +0000 (24 14:07 +0200)
treecc65fd77b693085ec8f2777b5c157b1fa92c57bc
parentf5821f526289badd667bcc288e5deaf5417466df
docs/devel/qapi-code-gen: Rewrite compatibility considerations

We have some compatibility advice buried in sections "Enumeration
types" and "Struct types".  Compatibility is actually about commands
and events.  It devolves to the types used there.  All kinds of types,
not just enumerations and structs.

Replace the existing advice by a new section "Compatibility
considerations".

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Message-Id: <20190913201349.24332-14-armbru@redhat.com>
[Squash in paragraph on invisible schema changes, as per Eric's review]
docs/devel/qapi-code-gen.txt