manta-cli 2.0.0-beta.30

Another CLI for ALPS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

//! Clap definition for `manta gen-man` — generate and install the
//! manta man pages (one `.1` file per subcommand) directly from the
//! running binary's clap tree.

use clap::{Command, ValueHint, arg, value_parser};
use std::path::PathBuf;

use super::output_flag;

pub fn subcommand_gen_man() -> Command {
  Command::new("gen-man")
    .about("Generate and install manta man pages")
    .long_about(
      "Generate one man-page (`.1`) per subcommand from the running \
       binary's clap tree and write them into the target directory.\n\n\
       Defaults to `$XDG_DATA_HOME/man/man1` (i.e. \
       `~/.local/share/man/man1`) when `--path` is omitted. The \
       directory is created if it doesn't exist.\n\n\
       After install, configure your shell so `man` finds the new \
       location — on Linux this directory is searched by default; on \
       macOS you may need `export MANPATH=\"$HOME/.local/share/man:$MANPATH\"`.",
    )
    .arg(
      arg!(-p --path <PATH> "Directory to write the `.1` files into (defaults to $XDG_DATA_HOME/man/man1)")
        .value_parser(value_parser!(PathBuf))
        .value_hint(ValueHint::DirPath),
    )
    .arg(output_flag())
}