From 0b14d92baf19ad01369d10e84bac1af4f57f179d Mon Sep 17 00:00:00 2001 From: Lyle Hanson Date: Wed, 12 Jun 2019 11:20:49 -0500 Subject: [PATCH] Document collecting log output Redirecting stdout writes log output to that file, but this wasn't easily discoverable. v2 removes changes to aerc-tutorial; I was also on the fence about that, and agree that it isn't on-topic for the tutorial. Addresses https://todo.sr.ht/~sircmpwn/aerc2/180 --- README.md | 4 ++++ doc/aerc.1.scd | 8 ++++++++ 2 files changed, 12 insertions(+) diff --git a/README.md b/README.md index dac8848..7a07406 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,10 @@ Then compile aerc: On its first run, aerc will copy the default config files to `~/.config/aerc` and show the account configuration wizard. +If you redirect stdout to a file, logging output will be written to that file: + + $ aerc > log + ## Resources [Send patches](https://git-send-email.io) and questions to diff --git a/doc/aerc.1.scd b/doc/aerc.1.scd index 7b09531..e7d3c59 100644 --- a/doc/aerc.1.scd +++ b/doc/aerc.1.scd @@ -132,6 +132,14 @@ message list, the message in the message viewer, etc). *close* Closes the terminal. +# LOGGING + +Aerc does not log by default, but collecting log output can be useful for +troubleshooting and reporting issues. Redirecting stdout when invoking aerc will +write log messages to that file: + + $ aerc > log + # SEE ALSO *aerc-config*(5) *aerc-imap*(5) *aerc-smtp*(5) *aerc-tutorial*(7)