mirror of
https://github.com/clap-rs/clap
synced 2024-12-14 06:42:33 +00:00
7110401595
This just affects how it's rendered; rather than attempting to highlight these blocks as a shell script, they'll get highlighted as console output. See the rendered versions for a better comparison.
38 lines
960 B
Markdown
38 lines
960 B
Markdown
*Jump to [source](pacman.rs)*
|
|
|
|
[`pacman`](https://wiki.archlinux.org/index.php/pacman) defines subcommands via flags.
|
|
|
|
Here, `-S` is a short flag subcommand:
|
|
```console
|
|
$ pacman -S package
|
|
Installing package...
|
|
|
|
```
|
|
|
|
Here `--sync` is a long flag subcommand:
|
|
```console
|
|
$ pacman --sync package
|
|
Installing package...
|
|
|
|
```
|
|
|
|
Now the short flag subcommand (`-S`) with a long flag:
|
|
```console
|
|
$ pacman -S --search name
|
|
Searching for name...
|
|
|
|
```
|
|
|
|
And the various forms of short flags that work:
|
|
```console
|
|
$ 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)*
|
|
|
|
**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.
|