qapi: Drop redundant documentation of inherited members
authorMarkus Armbruster <armbru@redhat.com>
Mon, 29 Jan 2024 11:50:04 +0000 (12:50 +0100)
committerMarkus Armbruster <armbru@redhat.com>
Sat, 3 Feb 2024 08:19:25 +0000 (09:19 +0100)
Documentation generated for SchemaInfo looks like

    The members of "SchemaInfoBuiltin" when "meta-type" is ""builtin""
    The members of "SchemaInfoEnum" when "meta-type" is ""enum""
    The members of "SchemaInfoArray" when "meta-type" is ""array""
    The members of "SchemaInfoObject" when "meta-type" is ""object""
    The members of "SchemaInfoAlternate" when "meta-type" is ""alternate""
    The members of "SchemaInfoCommand" when "meta-type" is ""command""
    The members of "SchemaInfoEvent" when "meta-type" is ""event""
    Additional members depend on the value of "meta-type".

The last line became redundant when commit 88f63467c57 (qapi2texi:
Generate reference to base type members) added the lines preceding it.
Drop it.

BlockdevOptions has the same issue.  Drop

    Remaining options are determined by the block driver.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20240129115008.674248-2-armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
qapi/block-core.json
qapi/introspect.json

index 48c181e55d48c8f0ef6f2adfaa017d80b8d5ffc6..530c4af50ff51622eab336acf1ec76cd53a0e8da 100644 (file)
 # @force-share: force share all permission on added nodes.  Requires
 #     read-only=true.  (Since 2.10)
 #
-# Remaining options are determined by the block driver.
-#
 # Since: 2.9
 ##
 { 'union': 'BlockdevOptions',
index 8df1ce85ed95bfe8e78010435d7b1028e580085d..b041b02ba8c5036f90d94f08f4b7ac193b048a60 100644 (file)
@@ -93,8 +93,6 @@
 #     particular order.  (since 4.1 for object types, 4.2 for
 #     commands, 5.0 for the rest)
 #
-# Additional members depend on the value of @meta-type.
-#
 # Since: 2.5
 ##
 { 'union': 'SchemaInfo',