mu4e.texi: update debugging information

This commit is contained in:
Dirk-Jan C. Binnema
2025-02-25 18:04:17 +02:00
parent 2714aa5e8c
commit 200ada5026

View File

@ -5052,24 +5052,26 @@ they differ.
@node Debugging @node Debugging
@appendix Debugging @appendix Debugging
As explained in @ref{How it works}, @t{mu4e} communicates with its As explained in @ref{How it works}, @t{mu4e} communicates with its backend
backend (@t{mu server}) by sending commands and receiving responses (@t{mu server}) by sending commands and receiving responses (s-expressions).
(s-expressions).
For debugging purposes, it can be very useful to see this data. For For debugging purposes, it can be very useful to see this data. For this reason,
this reason, @t{mu4e} can log all these messages. Note that the @t{mu4e} can log all these messages. Note that the `protocol' is documented to
`protocol' is documented to some extent in the @t{mu-server} manpage. some extent in the @t{mu-server} manpage.
You can enable (and disable) logging with @kbd{M-x You can enable (and disable) logging with @kbd{M-x mu4e-toggle-logging}. The
mu4e-toggle-logging}. The log-buffer is called @t{*mu4e-log*}, and in log-buffer is called @t{*mu4e-log*}, and in the @ref{Main view}, @ref{Headers
the @ref{Main view}, @ref{Headers view} and @ref{Message view}, view} and @ref{Message view}, there's a keybinding @key{$} that takes you there.
there's a keybinding @key{$} that takes you there. You can quit it by You can quit it by pressing @key{q}.
pressing @key{q}.
Logging can be a bit resource-intensive, so you may not want to leave it on all
the time.
@t{mu} itself keeps a log as well; depending on your system that could be in
your @t{systemd} journal, @t{syslog} or in @t{<MUHOME>/mu.log}, on Unix
typically @t{~/.cache/mu/mu.log}. To run the server in debug-mode, set
@var{mu4e-mu-debug} to @t{t} (before starting the server).
Logging can be a bit resource-intensive, so you may not want to leave
it on all the time. By default, the log only maintains the most recent
1200 lines. @t{mu} itself keeps a log as well, you can find it in
@t{<MUHOME>/mu.log}, on Unix typically @t{~/.cache/mu/mu.log}.
@node GNU Free Documentation License @node GNU Free Documentation License
@appendix GNU Free Documentation License @appendix GNU Free Documentation License