qemu-options: Remove stray colons from output of --help

Commit 43f187a broke --help: it put colons into blank lines.  It
removed the colon from DEFHEADING(TITLE:) and added it back in the
macro expansion of DEFHEADING(TITLE), so hxtool can emit "@subsection
TITLE" more easily.  Trouble is it's added back even for the blank
lines made with DEFHEADING().

Put the colons back where they were before commit 43f187a, and strip
them in hxtool instead.

Cc: Paolo Bonzini <pbonzini@redhat.com>
CC: qemu-stable@nongnu.org
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-Id: <20171002140307.5292-2-armbru@redhat.com>
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>
This commit is contained in:
Markus Armbruster 2017-10-02 16:03:00 +02:00
parent af352675ef
commit de6b4f908c
3 changed files with 17 additions and 15 deletions

View File

@ -14,7 +14,7 @@
#define ARCHHEADING(text, arch_mask) \
if ((arch_mask) & arch_type) \
puts(stringify(text) ":");
puts(stringify(text));
#define DEFHEADING(text) ARCHHEADING(text, QEMU_ARCH_ALL)

View File

@ -6,7 +6,7 @@ HXCOMM construct option structures, enums and help message for specified
HXCOMM architectures.
HXCOMM HXCOMM can be used for comments, discarded from both texi and C
DEFHEADING(Standard options)
DEFHEADING(Standard options:)
STEXI
@table @option
ETEXI
@ -584,7 +584,7 @@ STEXI
ETEXI
DEFHEADING()
DEFHEADING(Block device options)
DEFHEADING(Block device options:)
STEXI
@table @option
ETEXI
@ -1187,7 +1187,7 @@ STEXI
ETEXI
DEFHEADING()
DEFHEADING(USB options)
DEFHEADING(USB options:)
STEXI
@table @option
ETEXI
@ -1252,7 +1252,7 @@ STEXI
ETEXI
DEFHEADING()
DEFHEADING(Display options)
DEFHEADING(Display options:)
STEXI
@table @option
ETEXI
@ -1789,7 +1789,7 @@ STEXI
ETEXI
ARCHHEADING(, QEMU_ARCH_I386)
ARCHHEADING(i386 target only, QEMU_ARCH_I386)
ARCHHEADING(i386 target only:, QEMU_ARCH_I386)
STEXI
@table @option
ETEXI
@ -1905,7 +1905,7 @@ STEXI
ETEXI
DEFHEADING()
DEFHEADING(Network options)
DEFHEADING(Network options:)
STEXI
@table @option
ETEXI
@ -2486,7 +2486,7 @@ STEXI
ETEXI
DEFHEADING()
DEFHEADING(Character device options)
DEFHEADING(Character device options:)
STEXI
The general form of a character device option is:
@ -2819,7 +2819,7 @@ STEXI
ETEXI
DEFHEADING()
DEFHEADING(Device URL Syntax)
DEFHEADING(Device URL Syntax:)
STEXI
In addition to using normal file images for the emulated storage devices,
@ -3049,7 +3049,7 @@ STEXI
@end table
ETEXI
DEFHEADING(Bluetooth(R) options)
DEFHEADING(Bluetooth(R) options:)
STEXI
@table @option
ETEXI
@ -3125,7 +3125,7 @@ ETEXI
DEFHEADING()
#ifdef CONFIG_TPM
DEFHEADING(TPM device options)
DEFHEADING(TPM device options:)
DEF("tpmdev", HAS_ARG, QEMU_OPTION_tpmdev, \
"-tpmdev passthrough,id=id[,path=path][,cancel-path=path]\n"
@ -3215,7 +3215,7 @@ DEFHEADING()
#endif
DEFHEADING(Linux/Multiboot boot specific)
DEFHEADING(Linux/Multiboot boot specific:)
STEXI
When using these options, you can use a given Linux or Multiboot
@ -3271,7 +3271,7 @@ STEXI
ETEXI
DEFHEADING()
DEFHEADING(Debug/Expert options)
DEFHEADING(Debug/Expert options:)
STEXI
@table @option
ETEXI
@ -4178,7 +4178,8 @@ STEXI
@end table
ETEXI
DEFHEADING()
DEFHEADING(Generic object creation)
DEFHEADING(Generic object creation:)
STEXI
@table @option
ETEXI

View File

@ -19,7 +19,8 @@ hxtoh()
print_texi_heading()
{
if test "$*" != ""; then
printf "@subsection %s\n" "$*"
title="$*"
printf "@subsection %s\n" "${title%:}"
fi
}