Is the document outdated?

[yeongjet]

Question 1:

The cli argument name: pause_isolates_on_start in docs is not match pause-isolates-on-start displayed by the help command(dart help run -v):

    --[no-]pause-isolates-on-exit                      Pause isolates on exit when running with --enable-vm-service.
    --[no-]pause-isolates-on-unhandled-exceptions      Pause isolates when an unhandled exception is encountered when
                                                       running with --enable-vm-service.
    --[no-]warn-on-pause-with-no-debugger              Print a warning when an isolate pauses with no attached debugger
                                                       when running with --enable-vm-service.
    --timeline-streams=<str1, str2, ...>               Enables recording for specific timeline streams.
                                                       Valid streams include: all, API, Compiler, CompilerVerbose, Dart,
                                                       Debugger, Embedder, GC, Isolate, VM.
                                                       Defaults to "Compiler, Dart, GC" when --observe is provided.

Other debugging options:
 // here ->   --[no-]pause-isolates-on-start                     Pause isolates on start when running with --enable-vm-service.
    --timeline-recorder=<recorder>                     Selects the timeline recorder to use.
                                                       Valid recorders include: none, ring, endless, startup, systrace,
                                                       file, callback, perfettofile.
                                                       Defaults to ring.

The same situation applies to these two parameters: pause_isolates_on_exit and pause_isolates_on_unhandled_exceptions
Btw, both pause_isolates_on_start and pause-isolates-on-start seem to work on my testing. Here is the library which uses pause_isolates_on_exit

Question 2:

I noticed that some libraries use the parameters -DSILENT_OBSERVATORY=true and -DSILENT_VM_SERVICE=true, but these parameters seems not to appear in the documentation or the help command.

[mraleph]

VM flags are insensitive to - vs _ so both --x-y-z and --x_y_z do the same thing.

I noticed that some libraries use the parameters -DSILENT_OBSERVATORY=true and -DSILENT_VM_SERVICE=true, but these parameters seems not to appear in the documentation or the help command.

I would say that SILENT_OBSERVATORY and SILENT_VM_SERVICE are implementation details and that's why they are not documented anywhere.

cc @derekxu16

[a-siva]

I guess the question has been answered, closing issue.

[yeongjet]

Thanks! @mraleph @a-siva