mirror of
https://github.com/clap-rs/clap
synced 2024-12-13 22:32:33 +00:00
c9eef44213
This was ported over from the usage parser which modeled after docopt. We just never got around to implementing the rest of the syntax. However, when considering this as a standalone feature, an `arg!(--flag <value>)`, outside of other context, should be optional. This is how the help would display it. Fixes #4206
38 lines
1.3 KiB
Rust
38 lines
1.3 KiB
Rust
use clap::{arg, Command};
|
|
use clap_mangen::Man;
|
|
use std::io;
|
|
|
|
// Run this example as `cargo run --example man | man -l -`.
|
|
|
|
fn main() -> Result<(), std::io::Error> {
|
|
let cmd = Command::new("myapp")
|
|
.version("1.0")
|
|
.author("Kevin K. <kbknapp@gmail.com>:Ola Nordmann <old@nordmann.no>")
|
|
.about("Does awesome things")
|
|
.long_about(
|
|
"With a longer description to help clarify some things.
|
|
|
|
And a few newlines.",
|
|
)
|
|
.after_help("This is an extra section added to the end of the manpage.")
|
|
.after_long_help("With even more text added.")
|
|
.arg(
|
|
arg!(-c --config <FILE> "Sets a custom config file")
|
|
.long_help("Some more text about how to set a custom config file")
|
|
.default_value("config.toml")
|
|
.env("CONFIG_FILE"),
|
|
)
|
|
.arg(arg!([output] "Sets an output file").default_value("result.txt"))
|
|
.arg(
|
|
arg!(-d --debug ... "Turn debugging information on")
|
|
.env("DEBUG_ON")
|
|
.hide_env(true),
|
|
)
|
|
.subcommand(
|
|
Command::new("test")
|
|
.about("does testing things")
|
|
.arg(arg!(-l --list "Lists test values")),
|
|
);
|
|
|
|
Man::new(cmd).render(&mut io::stdout())
|
|
}
|