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

qapi: Add blank lines before bulleted lists

We would like to switch the doc comments to rST format. rST
insists on a blank line before and after a bulleted list, but our
Texinfo doc generator did not. Add some extra blank lines in the doc
comments so they're acceptable rST input.

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Message-Id: <20200213175647.17628-17-peter.maydell@linaro.org>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
[Commit message tweaked]
Signed-off-by: Markus Armbruster <armbru@redhat.com>

authored by

Peter Maydell and committed by
Markus Armbruster 100cc4fe e050e426

+5
+1
qapi/block-core.json
··· 4757 4757 # 4758 4758 # Once the tray opens, a DEVICE_TRAY_MOVED event is emitted. There are cases in 4759 4759 # which no such event will be generated, these include: 4760 + # 4760 4761 # - if the guest has locked the tray, @force is false and the guest does not 4761 4762 # respond to the eject request 4762 4763 # - if the BlockBackend denoted by @device does not have a guest device attached
+2
qapi/char.json
··· 133 133 # @data: data to write 134 134 # 135 135 # @format: data encoding (default 'utf8'). 136 + # 136 137 # - base64: data must be base64 encoded text. Its binary 137 138 # decoding gets written. 138 139 # - utf8: data's UTF-8 encoding is written ··· 167 168 # @size: how many bytes to read at most 168 169 # 169 170 # @format: data encoding (default 'utf8'). 171 + # 170 172 # - base64: the data read is returned in base64 encoding. 171 173 # - utf8: the data read is interpreted as UTF-8. 172 174 # Bug: can screw up when the buffer contains invalid UTF-8
+1
qapi/trace.json
··· 53 53 # Returns: a list of @TraceEventInfo for the matching events 54 54 # 55 55 # An event is returned if: 56 + # 56 57 # - its name matches the @name pattern, and 57 58 # - if @vcpu is given, the event has the "vcpu" property. 58 59 #
+1
qapi/ui.json
··· 934 934 # Input event union. 935 935 # 936 936 # @type: the input type, one of: 937 + # 937 938 # - 'key': Input event of Keyboard 938 939 # - 'btn': Input event of pointer buttons 939 940 # - 'rel': Input event of relative pointer motion