tests/qapi-schema: Rework comments on longhand member definitions
authorMarkus Armbruster <armbru@redhat.com>
Tue, 23 Mar 2021 09:40:00 +0000 (10:40 +0100)
committerMarkus Armbruster <armbru@redhat.com>
Tue, 23 Mar 2021 20:38:39 +0000 (21:38 +0100)
A few old comments talk about "desired future use of defaults" and
"anonymous inline branch types".  Kind of misleading since commit
87adbbffd4 "qapi: add a dictionary form for TYPE" added longhand
member definitions.  Talk about that instead.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-Id: <20210323094025.3569441-4-armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Reviewed-by: John Snow <jsnow@redhat.com>
tests/qapi-schema/event-member-invalid-dict.err
tests/qapi-schema/event-member-invalid-dict.json
tests/qapi-schema/flat-union-inline-invalid-dict.json
tests/qapi-schema/nested-struct-data-invalid-dict.err
tests/qapi-schema/nested-struct-data-invalid-dict.json
tests/qapi-schema/nested-struct-data.json
tests/qapi-schema/struct-member-invalid-dict.err
tests/qapi-schema/struct-member-invalid-dict.json

index c7a6a243050b1a8af645aeb597ecf558f4579cc6..82f8989344b3ee8a852ca6fbd6f9705fe0cce788 100644 (file)
@@ -1,2 +1,2 @@
 event-member-invalid-dict.json: In event 'EVENT_A':
-event-member-invalid-dict.json:1: 'data' member 'a' misses key 'type'
+event-member-invalid-dict.json:3: 'data' member 'a' misses key 'type'
index ee6f3ecb6f2017a9d7e9b21fc38c9ec05b662167..e58560abca8889362db89df387e45cb48da8de05 100644 (file)
@@ -1,2 +1,4 @@
+# event 'data' member with dict value is (longhand) argument
+# definition, not inline complex type
 { 'event': 'EVENT_A',
   'data': { 'a' : { 'string' : 'str', 'integer': 'int' }, 'b' : 'str' } }
index 62c7cda61750fa72701a3d6b2f626a65d9064d5a..1779712795c73a2279c9e6f5c9e371bdf404526b 100644 (file)
@@ -1,5 +1,5 @@
-# we require branches to be a struct name
-# TODO: should we allow anonymous inline branch types?
+# union 'data' member with dict value is (longhand) branch
+# definition, not inline complex type
 { 'enum': 'TestEnum',
   'data': [ 'value1', 'value2' ] }
 { 'struct': 'Base',
index c044b2b17afea67a6f816d012083f09858eb1b25..375e155fe6a6ba331a78179372705815c71251f3 100644 (file)
@@ -1,2 +1,2 @@
 nested-struct-data-invalid-dict.json: In command 'foo':
-nested-struct-data-invalid-dict.json:2: 'data' member 'a' misses key 'type'
+nested-struct-data-invalid-dict.json:3: 'data' member 'a' misses key 'type'
index efbe773dedf8195c2d44e977601fdaad0eccfd91..aa37b85e194c7581fa11db30a46f31cecb3613eb 100644 (file)
@@ -1,3 +1,4 @@
-# inline subtypes collide with our desired future use of defaults
+# command 'data' member with dict value is (longhand) argument
+# definition, not inline complex type
 { 'command': 'foo',
   'data': { 'a' : { 'string' : 'str', 'integer': 'int' }, 'b' : 'str' } }
index 5b8a40cca3f42c324c45d19df55db74ed826ee51..2980d45d0574275cebff3649dced81bb51fd7fdb 100644 (file)
@@ -1,3 +1,3 @@
-# inline subtypes collide with our desired future use of defaults
+# {} is not a valid type reference
 { 'command': 'foo',
   'data': { 'a' : { 'type': {} }, 'b' : 'str' } }
index 0621aecfbd0c4b60a7118b6291cb23e53f5155f3..f9b3f3355179ca9cd082fb77ec5f83feee29fdbc 100644 (file)
@@ -1,2 +1,2 @@
 struct-member-invalid-dict.json: In struct 'foo':
-struct-member-invalid-dict.json:2: 'data' member '*a' misses key 'type'
+struct-member-invalid-dict.json:3: 'data' member '*a' misses key 'type'
index 9fe0d455a9b98fe2a608692c38a2bee9ab13736d..bc3d62ae631b7ad52f1c4d6ffb97bd71f5f5b65c 100644 (file)
@@ -1,3 +1,4 @@
-# Long form of member must have a value member 'type'
+# struct 'data' member with dict value is (longhand) member
+# definition, not inline complex type
 { 'struct': 'foo',
   'data': { '*a': { 'case': 'foo' } } }