Skip to content

Commit fa24032

Browse files
committed
add catch_all documentation
1 parent f1503a2 commit fa24032

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -196,19 +196,19 @@ The `bashly.yml` configuration file consists of these types:
196196
Unless otherwise specified, these definitiona can be used for both the root
197197
command and subcommands (under the `commands` definition).
198198

199-
200199
Option | Description
201200
-----------|-------------
202201
`name` | The name of the script or subcommand.
203202
`short` | An additional, optional pattern - usually used to denote a one letter variation of the command name. You can add `*` as a suffix, to denote a "starts with" pattern - for example `short: m*`. *Applicable only in subcommands*.
204203
`help` | The header text to display when using `--help`. This option can have multiple lines. In this case, the first line will be used as summary wherever appropriate.
205204
`version` | The string to display when using `--version`. *Applicable only in the main command*.
206-
`default` | Setting this to `yes` on any command, will make unrecognized command line arguments to be passed to this command. *Applicable only in subcommands*.
205+
`default` | Setting this to `true` on any command, will make unrecognized command line arguments to be passed to this command. *Applicable only in subcommands*.
207206
`examples` | Specify an array of examples to show when using `--help`. Each example can have multiple lines.
208207
`environment_variables` | Specify an array of environment variables needed by your script.
209208
`commands` | Specify the array of commands. Each command will have its own args and flags. Note: if `commands` is provided, you cannot specify flags or args at the same level.
210209
`args` | Specify the array of positional arguments this script needs.
211210
`flags` | Specify the array of option flags this script needs.
211+
`catch_all` | Specify that this command should allow for additional arbitrary arguments or flags. It can be set in one of three ways:<br>- Set to `true` to just enable it.<br>- Set to a string, to use this string in the usage help text.<br>- Set to a hash containing `label` and `help` keys, to show a detailed help for it when running with `--help`.
212212
`dependencies` | Specify an array of any required external dependencies (commands). The script execution will be halted with a friendly error unless all dependency commands exist.
213213
`group` | In case you have many commands, use this option to specify a caption to display before this command. This option is purely for display purposes, and needs to be specified only for the first command in each group.
214214

0 commit comments

Comments
 (0)