[rustc.git] / vendor / clap / examples / multicall-busybox.md

See the documentation for [`Command::multicall`][crate::Command::multicall] for rationale.

This example omits every command except true and false,
which are the most trivial to implement,
```console
$ busybox true
? 0

$ busybox false
? 1

```
*Note: without the links setup, we can't demonstrate the multicall behavior*

But includes the `--install` option as an example of why it can be useful
for the main program to take arguments that aren't applet subcommands.
```console
$ busybox --install
? failed
...

```

Though users must pass something:
```console
$ busybox
? failed
Usage: busybox [OPTIONS] [APPLET]

APPLETS:
  true   does nothing successfully
  false  does nothing unsuccessfully
  help   Print this message or the help of the given subcommand(s)

Options:
      --install <install>  Install hardlinks for all subcommands in path
  -h, --help               Print help

```
Commit	Line	Data
6522a427 EL	1	See the documentation for [`Command::multicall`][crate::Command::multicall] for rationale.
	2
	3	This example omits every command except true and false,
	4	which are the most trivial to implement,
	5	```console
	6	$ busybox true
	7	? 0
	8
	9	$ busybox false
	10	? 1
	11
	12	```
	13	Note: without the links setup, we can't demonstrate the multicall behavior
	14
	15	But includes the `--install` option as an example of why it can be useful
	16	for the main program to take arguments that aren't applet subcommands.
	17	```console
	18	$ busybox --install
	19	? failed
	20	...
	21
	22	```
	23
	24	Though users must pass something:
	25	```console
	26	$ busybox
	27	? failed
	28	Usage: busybox [OPTIONS] [APPLET]
	29
	30	APPLETS:
	31	true does nothing successfully
	32	false does nothing unsuccessfully
	33	help Print this message or the help of the given subcommand(s)
	34
	35	Options:
	36	--install <install> Install hardlinks for all subcommands in path
	37	-h, --help Print help
	38
	39	```