Merge branch 'msg_refactor'

This branch changes mp_msg() so that it doesn't require global context.
The changes are pretty violent.

3 files changed, 19 insertions, 14 deletions

diff --git a/DOCS/man/en/af.rst b/DOCS/man/en/af.rst
index 52d2f7b478..e8b0e4adbd 100644
--- a/DOCS/man/en/af.rst
+++ b/DOCS/man/en/af.rst
@@ -422,7 +422,7 @@ Available filters are:
             Would delay front left and right by 10.5ms, the two rear channels
             and the subwoofer by 0ms and the center channel by 7ms.
 
-``export[=mmapped_file[:nsamples]]``
+``export=mmapped_file:nsamples]``
     Exports the incoming signal to other processes using memory mapping
     (``mmap()``). Memory mapped areas contain a header::
 
@@ -434,7 +434,7 @@ Available filters are:
     The rest is payload (non-interleaved) 16-bit data.
 
     ``<mmapped_file>``
-        File to map data to (default: ``~/.mpv/mpv-af_export``).
+        File to map data to (required)
     ``<nsamples>``
         number of samples per channel (default: 512).
 
diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst
index e15d6bb87f..0ea78512bd 100644
--- a/DOCS/man/en/changes.rst
+++ b/DOCS/man/en/changes.rst
@@ -179,6 +179,7 @@ Command Line Switches
     ``-panscanrange``           ``--video-zoom``, ``--video-pan-x/y``
     ``-pp ...``                 ``'--vf=pp=[...]'``
     ``-pphelp``                 ``--vf=pp:help``
+    ``-identify``               ``--msglevel=identify=trace``
     =========================== ========================================
 
 .. note::
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 9e7f55da2b..8c3e87abc7 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -1345,7 +1345,9 @@ OPTIONS
     Control verbosity directly for each module. The ``all`` module changes the
     verbosity of all the modules not explicitly specified on the command line.
 
-    See ``--msglevel=help`` for a list of all modules.
+    Run mpv with ``--msglevel=all=trace`` to see all messages mpv outputs. You
+    can use the module names printed in the output (prefixed to each line in
+    ``[...]``) to limit the output to interesting modules.
 
     .. note::
 
@@ -1356,17 +1358,19 @@ OPTIONS
 
     Available levels:
 
-    :-1: complete silence
-    :0:  fatal messages only
-    :1:  error messages
-    :2:  warning messages
-    :3:  short hints
-    :4:  informational messages
-    :5:  status messages (default)
-    :6:  verbose messages
-    :7:  debug level 2
-    :8:  debug level 3
-    :9:  debug level 4
+    :no:        complete silence
+    :fatal:     fatal messages only
+    :error:     error messages
+    :warn:      warning messages
+    :info:      informational messages
+    :status:    status messages (default)
+    :v:         verbose messages
+    :debug:     debug messages
+    :trace:     very noisy debug messages
+
+    One special case is the ``identify`` module name. This is silenced by
+    default, and can be set to ``trace`` level to enable the remains of the
+    code once enabled with the ``-identify`` option.
 
 ``--msgmodule``
     Prepend module name in front of each console message.