qemu with hax to log dma reads & writes jcs.org/2018/11/12/vfio

qapi2texi: Use category "Object" for all object types

At the protocol level, the distinction between struct, flat union and
simple union is meaningless, they are all JSON objects. Document them
that way.

Example change (qemu-qmp-ref.txt):

- -- Simple Union: InputEvent
+ -- Object: InputEvent

Input event union.

This also fixes the completely broken headings for flat and simple
unions in qemu-qmp-ref.7 and qemu-ga-ref.7, by sidestepping a bug in
texi2pod.pl. For instance, it mistranslates "@deftp {Simple Union}
InputEvent" to "B<Union> (Simple)", but translates "@deftp Object
InputEvent" to "B<SocketAddress> (Object)".

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Message-Id: <1489582656-31133-30-git-send-email-armbru@redhat.com>

+1 -7
+1 -7
scripts/qapi2texi.py
··· 219 219 220 220 def visit_object_type(self, name, info, base, members, variants): 221 221 doc = self.cur_doc 222 - if not variants: 223 - typ = 'Struct' 224 - elif variants._tag_name: # TODO unclean member access 225 - typ = 'Flat Union' 226 - else: 227 - typ = 'Simple Union' 228 222 if base and base.is_implicit(): 229 223 base = None 230 224 if self.out: 231 225 self.out += '\n' 232 - self.out += TYPE_FMT(type=typ, 226 + self.out += TYPE_FMT(type='Object', 233 227 name=doc.symbol, 234 228 body=texi_entity(doc, 'Members', base, variants)) 235 229