[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH] hmp: Fix texinfo documentation
From: |
Markus Armbruster |
Subject: |
[Qemu-devel] [PATCH] hmp: Fix texinfo documentation |
Date: |
Tue, 10 Mar 2015 13:23:04 +0100 |
Several issues:
* Commands i and o lack @item. Their one-liner documentation gets
squashed into the preceding command print. Add the obvious @item.
* Commands i, o and cpu-add lack @findex. The function index doesn't
have them. Add the obvious @findex.
* Commit 727f005 put block_set_io_throttle was added in the middle of
block_passwd. Move it.
* Correct spelling of commands chardev-add and chardev-remove in @item
and @findex.
* Some commands have a blank line between @item/@findex and the text,
most don't. Normalize to no blank line.
Signed-off-by: Markus Armbruster <address@hidden>
---
hmp-commands.hx | 41 +++++++++++++++--------------------------
1 file changed, 15 insertions(+), 26 deletions(-)
diff --git a/hmp-commands.hx b/hmp-commands.hx
index d5022d8..1cf0081 100644
--- a/hmp-commands.hx
+++ b/hmp-commands.hx
@@ -205,7 +205,6 @@ ETEXI
STEXI
@item change @var{device} @var{setting}
@findex change
-
Change the configuration of a device.
@table @option
@@ -523,7 +522,6 @@ ETEXI
STEXI
@item p or print/@var{fmt} @var{expr}
@findex print
-
Print expression value. Only the @var{format} part of @var{fmt} is
used.
ETEXI
@@ -537,6 +535,8 @@ ETEXI
},
STEXI
address@hidden i/@var{fmt} @var{addr} address@hidden
address@hidden i
Read I/O port.
ETEXI
@@ -549,6 +549,8 @@ ETEXI
},
STEXI
address@hidden o/@var{fmt} @var{addr} @var{val}
address@hidden o
Write to I/O port.
ETEXI
@@ -564,7 +566,6 @@ ETEXI
STEXI
@item sendkey @var{keys}
@findex sendkey
-
Send @var{keys} to the guest. @var{keys} could be the name of the
key or the raw value in hexadecimal format. Use @code{-} to press
several keys simultaneously. Example:
@@ -587,7 +588,6 @@ ETEXI
STEXI
@item system_reset
@findex system_reset
-
Reset the system.
ETEXI
@@ -602,7 +602,6 @@ ETEXI
STEXI
@item system_powerdown
@findex system_powerdown
-
Power down the system (if supported).
ETEXI
@@ -617,7 +616,6 @@ ETEXI
STEXI
@item sum @var{addr} @var{size}
@findex sum
-
Compute the checksum of a memory region.
ETEXI
@@ -632,7 +630,6 @@ ETEXI
STEXI
@item usb_add @var{devname}
@findex usb_add
-
Add the USB device @var{devname}. For details of available devices see
@ref{usb_devices}
ETEXI
@@ -648,7 +645,6 @@ ETEXI
STEXI
@item usb_del @var{devname}
@findex usb_del
-
Remove the USB device @var{devname} from the QEMU virtual USB
hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor
command @code{info usb} to see the devices you can remove.
@@ -667,7 +663,6 @@ ETEXI
STEXI
@item device_add @var{config}
@findex device_add
-
Add device.
ETEXI
@@ -683,7 +678,6 @@ ETEXI
STEXI
@item device_del @var{id}
@findex device_del
-
Remove device @var{id}.
ETEXI
@@ -824,7 +818,6 @@ ETEXI
STEXI
@item boot_set @var{bootdevicelist}
@findex boot_set
-
Define new values for the boot device list. Those values will override
the values specified on the command line through the @code{-boot} option.
@@ -1523,9 +1516,9 @@ ETEXI
},
STEXI
address@hidden block_set_io_throttle @var{device} @var{bps} @var{bps_rd}
@var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
address@hidden block_set_io_throttle
-Change I/O throttle limits for a block drive to @var{bps} @var{bps_rd}
@var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
address@hidden block_passwd @var{device} @var{password}
address@hidden block_passwd
+Set the encrypted device @var{device} password to @var{password}
ETEXI
{
@@ -1537,9 +1530,9 @@ ETEXI
},
STEXI
address@hidden block_passwd @var{device} @var{password}
address@hidden block_passwd
-Set the encrypted device @var{device} password to @var{password}
address@hidden block_set_io_throttle @var{device} @var{bps} @var{bps_rd}
@var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
address@hidden block_set_io_throttle
+Change I/O throttle limits for a block drive to @var{bps} @var{bps_rd}
@var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
ETEXI
{
@@ -1553,7 +1546,6 @@ ETEXI
STEXI
@item set_password [ vnc | spice ] password [ action-if-connected ]
@findex set_password
-
Change spice/vnc password. Use zero to make the password stay valid
forever. @var{action-if-connected} specifies what should happen in
case a connection is established: @var{fail} makes the password change
@@ -1573,7 +1565,6 @@ ETEXI
STEXI
@item expire_password [ vnc | spice ] expire-time
@findex expire_password
-
Specify when a password for spice/vnc becomes
invalid. @var{expire-time} accepts:
@@ -1604,9 +1595,8 @@ ETEXI
},
STEXI
address@hidden chardev_add args
address@hidden chardev_add
-
address@hidden chardev-add args
address@hidden chardev-add
chardev_add accepts the same parameters as the -chardev command line switch.
ETEXI
@@ -1621,9 +1611,8 @@ ETEXI
},
STEXI
address@hidden chardev_remove id
address@hidden chardev_remove
-
address@hidden chardev-remove id
address@hidden chardev-remove
Removes the chardev @var{id}.
ETEXI
@@ -1639,7 +1628,6 @@ ETEXI
STEXI
@item qemu-io @var{device} @var{command}
@findex qemu-io
-
Executes a qemu-io command on the given block device.
ETEXI
@@ -1654,6 +1642,7 @@ ETEXI
STEXI
@item cpu-add @var{id}
address@hidden cpu-add
Add CPU with id @var{id}
ETEXI
--
1.9.3
- [Qemu-devel] [PATCH] hmp: Fix texinfo documentation,
Markus Armbruster <=