Document shared debug input and reporting mode
This commit is contained in:
@@ -178,8 +178,11 @@ Reporting flags do not go before or between command-path components. Tokens
|
||||
consumed as values and tokens after `--` retain their normal meaning.
|
||||
|
||||
The reserved long spellings are `--quiet`, `--verbose`, `--debug`,
|
||||
`--progress`, and `--format`; application declarations cannot reuse them. There
|
||||
are no built-in short spellings. Applications may define aliases such as `-q → --quiet`,
|
||||
`--progress`, and `--format`. An application may attach its own boolean input
|
||||
to the existing `--debug` option. Command help shows both purposes in one row,
|
||||
including an application short spelling, requiredness, and any different
|
||||
application default. Application input defaults do not select reporting mode.
|
||||
There are no built-in short spellings. Applications may define aliases such as `-q → --quiet`,
|
||||
`-v → --verbose`, and `-d → --debug`; canonical and aliased occurrences share
|
||||
the same ordering. Thus `example export --verbose -q` selects quiet mode.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user