aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRobin Jarry <robin@jarry.cc>2022-11-19 14:34:10 +0100
committerRobin Jarry <robin@jarry.cc>2022-11-21 13:18:34 +0100
commite5f2fb08d8a7604aeef726698ef696874bcd2561 (patch)
tree6927564ae1f016abc16bb9c5041969092c3ba10c /doc
parent9db3710dd73b6949321a028b4dc2dc2277e97ce0 (diff)
downloadaerc-e5f2fb08d8a7604aeef726698ef696874bcd2561.tar.gz
config: add log-file and log-level settings
Allow configuring persistent logging to file with a log level. When redirecting the output of aerc to a file these two settings are ignored and all messages are printed to stdout. Suggested-by: Moritz Poldrack <moritz@poldrack.dev> Suggested-by: Tim Culverhouse <tim@timculverhouse.com> Signed-off-by: Robin Jarry <robin@jarry.cc> Acked-by: Tim Culverhouse <tim@timculverhouse.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/aerc-config.5.scd16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd
index e40630bc..f18b5110 100644
--- a/doc/aerc-config.5.scd
+++ b/doc/aerc-config.5.scd
@@ -45,6 +45,22 @@ These options are configured in the *[general]* section of aerc.conf.
Default: false
+*log-file*
+ Output log messages to specified file. A path starting with _~/_ is
+ expanded to the user home dir. When redirecting aerc's output to a file
+ using _>_ shell redirection, this setting is ignored and log messages
+ are printed to stdout.
+
+ Default: ""
+
+*log-level*
+ Only log messages above the specified level to *log-file*. Supported
+ levels are: _debug_, _info_, _warn_ and _error_. When redirecting aerc's
+ output to a file using _>_ shell redirection, this setting is ignored
+ and the log level is forced to _debug_.
+
+ Default: _info_
+
## UI OPTIONS
These options are configured in the *[ui]* section of aerc.conf.