scala / scala3

The Scala 3 compiler, also known as Dotty.
https://dotty.epfl.ch
Apache License 2.0
5.88k stars 1.06k forks source link

Command line tools : option "-help" #11453

Closed michelou closed 3 years ago

michelou commented 3 years ago

Behavior of command line option -help is incorrect with Scala 3 (see also issue 11452) :

Scala 2 output

The three commands scala, scalac and scaladoc print some help message :

user@host MINGW64 /w/dotty
$ export JAVA_HOME=/c/opt/jdk-1.8.0_282-b08/

user@host MINGW64 /w/dotty
$ /c/opt/scala-2.13.4/bin/scala -help 2>&1 | head -4
Usage: scala <options> [<script|class|object|jar> <arguments>]
   or  scala -help

All options to scalac (see scalac -help) are also allowed.

user@host MINGW64 /w/dotty
$ /c/opt/scala-2.13.4/bin/scalac -help 2>&1 | head -4
Usage: scalac <options> <source files>

Standard options:
  -Dproperty=value             Pass -Dproperty=value directly to the runtime system.

user@host MINGW64 /w/dotty
$ /c/opt/scala-2.13.4/bin/scaladoc -help 2>&1 | head -4
Usage: scaladoc <options> <source files>

where possible scaladoc options:
  -author                                     Include authors. [false]

Scala 3 output

Only scalac behaves correctly :

user@host MINGW64 /w/dotty
$ /c/opt/scala-3.0.0-RC1/bin/scala -help
Starting scala3 REPL...
scala> :quit

user@host MINGW64 /w/dotty
$ /c/opt/scala-3.0.0-RC1/bin/scalac -help 2>&1 | head -4
Usage: scalac <options> <source files>
where possible standard options include:
-P                                                Pass an option to a plugin, e.g. -P:<plugin>:<opt>
-X                                                Print a synopsis of advanced options.

user@host MINGW64 /w/dotty
$ /c/opt/scala-3.0.0-RC1/bin/scaladoc -help 2>&1 | head -4
Destination is not provided, please provide '-d' parameter pointing to directory where docs should be created
Failure

Expectation

Same behavior for Scala 2 and Scala 3.

som-snytt commented 3 years ago

Also mentioned at https://github.com/lampepfl/dotty/issues/8095