OpenE2K/qemu-e2k
13
4
Fork 0
Code Issues 4 Pull Requests Projects 2 Releases Activity

qga/qapi-schema: Refill doc comments to conform to current conventions

Browse Source 
For legibility, wrap text paragraphs so every line is at most 70
characters long.

To check the generated documentation does not change, I compared the
generated HTML before and after this commit with "wdiff -3".  Finds no
differences.  Comparing with diff is not useful, as the refilled
paragraphs are visible there.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20240322140910.328840-13-armbru@redhat.com>
This commit is contained in:
Markus Armbruster 2024-03-22 15:09:10 +01:00
parent 5305a4eeb8
commit 7270819384
1 changed files with 17 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
qga/qapi-schema.json
View File

@ -1220,13 +1220,13 @@
# @signal: signal number (linux) or unhandled exception code (windows) # @signal: signal number (linux) or unhandled exception code (windows)
# if the process was abnormally terminated. # if the process was abnormally terminated.
# #
# @out-data: base64-encoded stdout of the process. This field will only # @out-data: base64-encoded stdout of the process. This field will
# be populated after the process exits. # only be populated after the process exits.
# #
# @err-data: base64-encoded stderr of the process. Note: @out-data and # @err-data: base64-encoded stderr of the process. Note: @out-data
# @err-data are present only if 'capture-output' was specified for # and @err-data are present only if 'capture-output' was specified
# 'guest-exec'. This field will only be populated after the process # for 'guest-exec'. This field will only be populated after the
# exits. # process exits.
# #
# @out-truncated: true if stdout was not fully captured due to size # @out-truncated: true if stdout was not fully captured due to size
# limitation. # limitation.
@ -1273,12 +1273,16 @@
# An enumeration of guest-exec capture modes. # An enumeration of guest-exec capture modes.
# #
# @none: do not capture any output # @none: do not capture any output
#
# @stdout: only capture stdout # @stdout: only capture stdout
#
# @stderr: only capture stderr # @stderr: only capture stderr
#
# @separated: capture both stdout and stderr, but separated into # @separated: capture both stdout and stderr, but separated into
# GuestExecStatus out-data and err-data, respectively # GuestExecStatus out-data and err-data, respectively
# @merged: capture both stdout and stderr, but merge together #
# into out-data. not effective on windows guests. # @merged: capture both stdout and stderr, but merge together into
# out-data. Not effective on windows guests.
# #
# Since: 8.0 # Since: 8.0
## ##
@ -1291,8 +1295,9 @@
# #
# Controls what guest-exec output gets captures. # Controls what guest-exec output gets captures.
# #
# @flag: captures both stdout and stderr if true. Equivalent # @flag: captures both stdout and stderr if true. Equivalent to
# to GuestExecCaptureOutputMode::all. (since 2.5) # GuestExecCaptureOutputMode::all. (since 2.5)
#
# @mode: capture mode; preferred interface # @mode: capture mode; preferred interface
# #
# Since: 8.0 # Since: 8.0
@ -1315,7 +1320,7 @@
# @input-data: data to be passed to process stdin (base64 encoded) # @input-data: data to be passed to process stdin (base64 encoded)
# #
# @capture-output: bool flag to enable capture of stdout/stderr of # @capture-output: bool flag to enable capture of stdout/stderr of
# running process. defaults to false. # running process. Defaults to false.
# #
# Returns: PID # Returns: PID
# #