#132 Incorrect `log` command arg in "How to enable and view diagnostic logs" help page

[James SF DeLaHunt]

The Help page How to enable and view diagnostic logs instructs us to run the macOS shell log stream command with an arg: --level=debug.

I believe this syntax is incorrect. When I try it, the log command prints usage information, which includes:

options:
    --[no-]debug                  Control whether "Debug" events are shown

So, I believe that this page should use the syntax --debug not --level=debug.

[Erwin Bonsma]

Thanks for the report.

It looks as if this is a change in the log command, as I think you are on an older version of macOS than I am (I am on Golden Gate 27.0 Beta, whereas I think you are on Sonama 14.8, from the info you shared on another bug report). I am assuming it used to be --debug, and now is --level-debug.

This is the help that I get:

options:
    -l, --level default | info | debug Include events at, and below, the given level

Anyway, --debug is still also supported. The semantics are slightly different, as it does not enable info as well, but as that is enabled by default, the result is the same. So for now I will recommend that setting in the help documentation.