ShuriZma
/
xemu
mirror of https://github.com/xemu-project/xemu.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

qapi2texi: Implement boxed argument documentation 

This replaces manual references like "For the arguments, see the
documentation of ..." by a generated reference "Arguments: the members
of ...".

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Message-Id: <1489582656-31133-25-git-send-email-armbru@redhat.com>
This commit is contained in:
Markus Armbruster 2017-03-15 13:57:13 +01:00
parent 2c99f5fdc8
commit c2dd311cb7
3 changed files with 8 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
qapi-schema.json
View File

@ -1017,7 +1017,7 @@
## ##
# @migrate-set-parameters: # @migrate-set-parameters:
# #
# Set various migration parameters. See MigrationParameters for details. # Set various migration parameters.
# #
# Since: 2.4 # Since: 2.4
# #

10
qapi/block-core.json
View File

@ -1341,8 +1341,6 @@
# The operation can be stopped before it has completed using the # The operation can be stopped before it has completed using the
# block-job-cancel command. # block-job-cancel command.
# #
# For the arguments, see the documentation of DriveBackup.
#
# Returns: nothing on success # Returns: nothing on success
# If @device is not a valid block device, GenericError # If @device is not a valid block device, GenericError
# #
@ -1369,8 +1367,6 @@
# The operation can be stopped before it has completed using the # The operation can be stopped before it has completed using the
# block-job-cancel command. # block-job-cancel command.
# #
# For the arguments, see the documentation of BlockdevBackup.
#
# Returns: nothing on success # Returns: nothing on success
# If @device is not a valid block device, DeviceNotFound # If @device is not a valid block device, DeviceNotFound
# #
@ -1458,8 +1454,6 @@
# format of the mirror image, default is to probe if mode='existing', # format of the mirror image, default is to probe if mode='existing',
# else the format of the source. # else the format of the source.
# #
# See DriveMirror for parameter descriptions
#
# Returns: nothing on success # Returns: nothing on success
# If @device is not a valid block device, GenericError # If @device is not a valid block device, GenericError
# #
@ -1731,8 +1725,6 @@
# the device will be removed from its group and the rest of its # the device will be removed from its group and the rest of its
# members will not be affected. The 'group' parameter is ignored. # members will not be affected. The 'group' parameter is ignored.
# #
# See BlockIOThrottle for parameter descriptions.
#
# Returns: Nothing on success # Returns: Nothing on success
# If @device is not a valid block device, DeviceNotFound # If @device is not a valid block device, DeviceNotFound
# #
@ -2915,8 +2907,6 @@
# BlockBackend will be created; otherwise, @node-name is mandatory at the top # BlockBackend will be created; otherwise, @node-name is mandatory at the top
# level and no BlockBackend will be created. # level and no BlockBackend will be created.
# #
# For the arguments, see the documentation of BlockdevOptions.
#
# Note: This command is still a work in progress. It doesn't support all # Note: This command is still a work in progress. It doesn't support all
# block drivers among other things. Stay away from it unless you want # block drivers among other things. Stay away from it unless you want
# to help with its development. # to help with its development.

8
scripts/qapi2texi.py
View File

@ -220,9 +220,15 @@ class QAPISchemaGenDocVisitor(qapi.QAPISchemaVisitor):
doc = self.cur_doc doc = self.cur_doc
if self.out: if self.out:
self.out += '\n' self.out += '\n'
if boxed:
body = texi_body(doc)
body += '\n@b{Arguments:} the members of @code{%s}' % arg_type.name
body += texi_sections(doc)
else:
body = texi_entity(doc, 'Arguments')
self.out += MSG_FMT(type='Command', self.out += MSG_FMT(type='Command',
name=doc.symbol, name=doc.symbol,
body=texi_entity(doc, 'Arguments')) body=body)
def visit_event(self, name, info, arg_type, boxed): def visit_event(self, name, info, arg_type, boxed):
doc = self.cur_doc doc = self.cur_doc