Skip to content

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

@bjornregnell

Description

@bjornregnell

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?

Metadata

Metadata

Assignees

No one assigned

    Labels

    REPLIssues tied with the repl sub-command.bugSomething isn't workinghelpAll the issues related to improving help outputs

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions