pxcloud/vhost-device
5
0
Fork 0
mirror of https://github.com/rust-vmm/vhost-device.git synced 2025-12-25 14:15:10 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
main
vhost-device/xtask
History
Manos Pitsidianakis 5e83c07f87 xtask: generate manpage for vhost-device-scsi 
Signed-off-by: Manos Pitsidianakis <manos.pitsidianakis@linaro.org>
2025-11-13 14:59:23 +01:00
..
src xtask: generate manpage for vhost-device-scsi 2025-11-13 14:59:23 +01:00
build.rs Add an xtask crate to generate manpages 2025-04-15 14:25:32 +05:30
Cargo.toml xtask: generate manpage for vhost-device-scsi 2025-11-13 14:59:23 +01:00
README.md xtask: generate manpage for vhost-device-scsi 2025-11-13 14:59:23 +01:00

README.md

xtask - Run tasks with cargo

This binary crate provides support for running useful tasks with cargo xtask <..>.

mangen

The mangen task which is enabled by the mangen cargo feature, builds ROFF manual pages for binary crates in this repository. It uses the clap_mangen crate to generate ROFF from the crate's argument types which implement the clap::CommandFactory trait, through the clap::Parser derive macro.

Furthmore, if the README.md of a crate contains an Examples heading, it includes it in the manual page.

$ cargo xtask mangen
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.04s
     Running `target/debug/xtask mangen`
Generated the following manual pages:
/path/to/rust-vmm/vhost-device/target/dist/man/vhost-device-sound.1
/path/to/rust-vmm/vhost-device/target/dist/man/vhost-device-scmi.1

The following crates have manual pages built by default:

  • vhost-device-sound, enabled by the default feature vhost-device-sound.
    • It can further be fine-tuned with the features vhost-device-sound-pipewire and vhost-device-sound-alsa.
  • vhost-device-scmi, enabled by the default feature vhost-device-scmi.
  • vhost-device-scsi, enabled by the default feature vhost-device-scsi.