mirror of
https://github.com/clap-rs/clap
synced 2024-12-12 13:52:34 +00:00
11076a5c70
Force sorting with `next_display_order(None)` Fixes #2808
1.9 KiB
1.9 KiB
pacman
defines subcommands via flags.
Here, -S
is a short flag subcommand:
$ pacman -S package
Installing package...
Here --sync
is a long flag subcommand:
$ pacman --sync package
Installing package...
Now the short flag subcommand (-S
) with a long flag:
$ pacman -S --search name
Searching for name...
And the various forms of short flags that work:
$ pacman -S -s name
Searching for name...
$ pacman -Ss name
Searching for name...
(users can "stack" short subcommands with short flags or with other short flag subcommands)
In the help, this looks like:
$ pacman -h
pacman 5.2.1
Pacman Development Team
package manager utility
USAGE:
pacman[EXE] <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
-V, --version Print version information
SUBCOMMANDS:
query -Q --query Query the package database.
sync -S --sync Synchronize packages.
help Print this message or the help of the given subcommand(s)
$ pacman -S -h
pacman-sync
Synchronize packages.
USAGE:
pacman[EXE] {sync|--sync|-S} [OPTIONS] [--] [package]...
ARGS:
<package>... packages
OPTIONS:
-s, --search <search>... search remote repositories for matching strings
-i, --info view package information
-h, --help Print help information
And errors:
$ pacman -S -s foo -i bar
? failed
error: The argument '--search <search>...' cannot be used with '--info'
USAGE:
pacman[EXE] {sync|--sync|-S} --search <search>... <package>...
For more information try --help
NOTE: Keep in mind that subcommands, flags, and long flags are case sensitive: -Q
and -q
are different flags/subcommands. For example, you can have both -Q
subcommand and -q
flag, and they will be properly disambiguated.
Let's make a quick program to illustrate.