scala-cli icon indicating copy to clipboard operation
scala-cli copied to clipboard

confusing help commands as help is distrubuted over --help --help-full --help-repl etc

Open bjornregnell opened this issue 1 month ago • 1 comments

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?

bjornregnell avatar Nov 21 '25 11:11 bjornregnell

see also discussion here: https://github.com/scala/scala3/discussions/24492#discussioncomment-15037322

bjornregnell avatar Nov 21 '25 12:11 bjornregnell