For information about the cargo xtask workflow pattern see: <https://github.com/matklad/cargo-xtask>
This commit adds an xtask crate with only one task, "mangen", which
generates a ROFF manual page under `target/dist/man` directory for the
vhost-device-sound binary.
The xtask crate can be configured using cargo features, to help
packagers configure what manpages are generated.
This generates a manpage in target/dist/man/vhost-device-sound.1
The rendered ROFF output looks like:
vhost-device-sound(1) General Commands Manual vhost-device-sound(1)
NAME
vhost-device-sound - A virtio-sound device using the vhost-user protocol.
SYNOPSIS
vhost-device-sound <--socket> <--backend> [-h|--help] [-V|--version]
DESCRIPTION
A virtio-sound device using the vhost-user protocol.
OPTIONS
--socket=SOCKET
vhost-user Unix domain socket path
--backend=BACKEND
audio backend to be used
[possible values: null, pipewire, alsa]
-h, --help
Print help
-V, --version
Print version
VERSION
v0.2.0
REPORTING BUGS
Report bugs to the project's issue tracker: https://github.com/rust-vmm/vhost-device
vhost-device-sound 0.2.0 vhost-device-sound(1)
Fixes#687 ("Add man page for vhost-device-sound")
Resolves: https://github.com/rust-vmm/vhost-device/issues/687
Signed-off-by: Manos Pitsidianakis <manos.pitsidianakis@linaro.org>
