doc: Fix texinfo @table markup in qemu-options.hx

End tables before headings, start new ones afterwards.  Fixes
incorrect indentation of headings "File system options" and "Virtual
File system pass-through options" in manual page and qemu-doc.

Normalize markup some to increase chances it survives future edits.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Message-id: 1360781383-28635-5-git-send-email-armbru@redhat.com
Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
This commit is contained in:
Markus Armbruster 2013-02-13 19:49:40 +01:00 committed by Anthony Liguori
parent 6265c43b0c
commit c70a01e449
1 changed files with 39 additions and 21 deletions

View File

@ -539,13 +539,15 @@ STEXI
@end table @end table
ETEXI ETEXI
STEXI
USB options:
@table @option
ETEXI
DEF("usb", 0, QEMU_OPTION_usb, DEF("usb", 0, QEMU_OPTION_usb,
"-usb enable the USB driver (will be the default soon)\n", "-usb enable the USB driver (will be the default soon)\n",
QEMU_ARCH_ALL) QEMU_ARCH_ALL)
STEXI STEXI
USB options:
@table @option
@item -usb @item -usb
@findex -usb @findex -usb
Enable the USB driver (will be the default soon) Enable the USB driver (will be the default soon)
@ -612,9 +614,15 @@ possible drivers and properties, use @code{-device help} and
@code{-device @var{driver},help}. @code{-device @var{driver},help}.
ETEXI ETEXI
STEXI
@end table
ETEXI
DEFHEADING() DEFHEADING()
DEFHEADING(File system options:) DEFHEADING(File system options:)
STEXI
@table @option
ETEXI
DEF("fsdev", HAS_ARG, QEMU_OPTION_fsdev, DEF("fsdev", HAS_ARG, QEMU_OPTION_fsdev,
"-fsdev fsdriver,id=id[,path=path,][security_model={mapped-xattr|mapped-file|passthrough|none}]\n" "-fsdev fsdriver,id=id[,path=path,][security_model={mapped-xattr|mapped-file|passthrough|none}]\n"
@ -678,9 +686,15 @@ Specifies the tag name to be used by the guest to mount this export point
ETEXI ETEXI
STEXI
@end table
ETEXI
DEFHEADING() DEFHEADING()
DEFHEADING(Virtual File system pass-through options:) DEFHEADING(Virtual File system pass-through options:)
STEXI
@table @option
ETEXI
DEF("virtfs", HAS_ARG, QEMU_OPTION_virtfs, DEF("virtfs", HAS_ARG, QEMU_OPTION_virtfs,
"-virtfs local,path=path,mount_tag=tag,security_model=[mapped-xattr|mapped-file|passthrough|none]\n" "-virtfs local,path=path,mount_tag=tag,security_model=[mapped-xattr|mapped-file|passthrough|none]\n"
@ -771,11 +785,9 @@ ETEXI
STEXI STEXI
@end table @end table
ETEXI ETEXI
DEFHEADING() DEFHEADING()
DEFHEADING(Display options:) DEFHEADING(Display options:)
STEXI STEXI
@table @option @table @option
ETEXI ETEXI
@ -1217,7 +1229,6 @@ ETEXI
STEXI STEXI
@end table @end table
ETEXI ETEXI
ARCHHEADING(, QEMU_ARCH_I386) ARCHHEADING(, QEMU_ARCH_I386)
ARCHHEADING(i386 target only:, QEMU_ARCH_I386) ARCHHEADING(i386 target only:, QEMU_ARCH_I386)
@ -1302,10 +1313,10 @@ Specify SMBIOS type 0 fields
Specify SMBIOS type 1 fields Specify SMBIOS type 1 fields
ETEXI ETEXI
DEFHEADING()
STEXI STEXI
@end table @end table
ETEXI ETEXI
DEFHEADING()
DEFHEADING(Network options:) DEFHEADING(Network options:)
STEXI STEXI
@ -1720,13 +1731,19 @@ libpcap, so it can be analyzed with tools such as tcpdump or Wireshark.
Indicate that no network devices should be configured. It is used to Indicate that no network devices should be configured. It is used to
override the default configuration (@option{-net nic -net user}) which override the default configuration (@option{-net nic -net user}) which
is activated if no @option{-net} options are provided. is activated if no @option{-net} options are provided.
@end table
ETEXI ETEXI
STEXI
@end table
ETEXI
DEFHEADING() DEFHEADING()
DEFHEADING(Character device options:) DEFHEADING(Character device options:)
STEXI
The general form of a character device option is:
@table @option
ETEXI
DEF("chardev", HAS_ARG, QEMU_OPTION_chardev, DEF("chardev", HAS_ARG, QEMU_OPTION_chardev,
"-chardev null,id=id[,mux=on|off]\n" "-chardev null,id=id[,mux=on|off]\n"
@ -1768,10 +1785,6 @@ DEF("chardev", HAS_ARG, QEMU_OPTION_chardev,
) )
STEXI STEXI
The general form of a character device option is:
@table @option
@item -chardev @var{backend} ,id=@var{id} [,mux=on|off] [,@var{options}] @item -chardev @var{backend} ,id=@var{id} [,mux=on|off] [,@var{options}]
@findex -chardev @findex -chardev
Backend is one of: Backend is one of:
@ -1992,14 +2005,15 @@ Connect to a spice virtual machine channel, such as vdiport.
Connect to a spice port, allowing a Spice client to handle the traffic Connect to a spice port, allowing a Spice client to handle the traffic
identified by a name (preferably a fqdn). identified by a name (preferably a fqdn).
@end table
ETEXI ETEXI
STEXI
@end table
ETEXI
DEFHEADING() DEFHEADING()
STEXI
DEFHEADING(Device URL Syntax:) DEFHEADING(Device URL Syntax:)
STEXI
In addition to using normal file images for the emulated storage devices, In addition to using normal file images for the emulated storage devices,
QEMU can also use networked resources such as iSCSI devices. These are QEMU can also use networked resources such as iSCSI devices. These are
@ -2115,10 +2129,16 @@ qemu-system-x86_84 --drive file=gluster://192.0.2.1/testvol/a.img
@end example @end example
See also @url{http://www.gluster.org}. See also @url{http://www.gluster.org}.
ETEXI
STEXI
@end table @end table
ETEXI ETEXI
DEFHEADING(Bluetooth(R) options:) DEFHEADING(Bluetooth(R) options:)
STEXI
@table @option
ETEXI
DEF("bt", HAS_ARG, QEMU_OPTION_bt, \ DEF("bt", HAS_ARG, QEMU_OPTION_bt, \
"-bt hci,null dumb bluetooth HCI - doesn't respond to commands\n" \ "-bt hci,null dumb bluetooth HCI - doesn't respond to commands\n" \
@ -2132,8 +2152,6 @@ DEF("bt", HAS_ARG, QEMU_OPTION_bt, \
" emulate a bluetooth device 'dev' in scatternet 'n'\n", " emulate a bluetooth device 'dev' in scatternet 'n'\n",
QEMU_ARCH_ALL) QEMU_ARCH_ALL)
STEXI STEXI
@table @option
@item -bt hci[...] @item -bt hci[...]
@findex -bt @findex -bt
Defines the function of the corresponding Bluetooth HCI. -bt options Defines the function of the corresponding Bluetooth HCI. -bt options
@ -2185,9 +2203,11 @@ currently:
@item keyboard @item keyboard
Virtual wireless keyboard implementing the HIDP bluetooth profile. Virtual wireless keyboard implementing the HIDP bluetooth profile.
@end table @end table
@end table
ETEXI ETEXI
STEXI
@end table
ETEXI
DEFHEADING() DEFHEADING()
DEFHEADING(Linux/Multiboot boot specific:) DEFHEADING(Linux/Multiboot boot specific:)
@ -2244,11 +2264,9 @@ ETEXI
STEXI STEXI
@end table @end table
ETEXI ETEXI
DEFHEADING() DEFHEADING()
DEFHEADING(Debug/Expert options:) DEFHEADING(Debug/Expert options:)
STEXI STEXI
@table @option @table @option
ETEXI ETEXI