Summary
The auto-generated --help option has the description "Display help (use --help=all for all options)", but --help=all produces identical output to --help when using AeshRuntimeRunner (non-interactive CLI mode).
$ diff <(app --help) <(app --help=all)
# no differences
The --help=all feature appears designed for aesh's interactive console mode where it can recursively show help for all subcommands. In non-interactive CLI usage, it's a no-op.
Suggestion
Either:
- Make
--help=all actually show expanded help in non-interactive mode (e.g., list subcommands with their full options), or
- Change the auto-generated description to just "Display help" when not in interactive mode, removing the misleading
--help=all reference
Context
Found in jbang (jbangdev/jbang#2453). Users see the hint and try --help=all expecting more detail, but get the same output.
Summary
The auto-generated
--helpoption has the description "Display help (use --help=all for all options)", but--help=allproduces identical output to--helpwhen usingAeshRuntimeRunner(non-interactive CLI mode).The
--help=allfeature appears designed for aesh's interactive console mode where it can recursively show help for all subcommands. In non-interactive CLI usage, it's a no-op.Suggestion
Either:
--help=allactually show expanded help in non-interactive mode (e.g., list subcommands with their full options), or--help=allreferenceContext
Found in jbang (jbangdev/jbang#2453). Users see the hint and try
--help=allexpecting more detail, but get the same output.