scala-cli
scala-cli copied to clipboard
confusing help commands as help is distrubuted over --help --help-full --help-repl etc
Version(s) 1.10.1
Describe the bug
It is difficult to know where to get help on different sub-parts and it is surprising that --help-full does not provide help on e.g. --repl-init-script
To Reproduce
$ scala-cli --help | grep init
$ scala-cli --help-full | grep init
--initial-launcher, --initial-launcher-path string?
$ scala-cli --help-repl | grep init
-experimental Annotate all top-level definitions with
- experimental.erasedDefinitions :
Allow erased definitions,
-repl-init-script The code will be run on REPL startup.
-repl-quit-after-init Quit REPL after evaluating the init script.
Expected behaviour
When I use --help I expect to find what I'm looking for among all options available (not just some), and not having to go through a lot of different help texts...
As --help is already so many lines that it does not fit on a normal screen, perhaps its better to consolidate all --help, --help--full, --help-repl etc into one helpful helper somehow?
see also discussion here: https://github.com/scala/scala3/discussions/24492#discussioncomment-15037322