From 59b6a013ce98cd942e21a54ed3753194556f49f5 Mon Sep 17 00:00:00 2001 From: Aden Date: Fri, 24 Oct 2025 11:07:03 +1100 Subject: [PATCH] Document the log.append_file configuration key This flag is extremely useful but I couldn't find any documentation referencing it. I only found it once I started having a poke through the source code, so hopefully this will save others a little bit of time :) --- doc/manual/logging.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/manual/logging.md b/doc/manual/logging.md index 19441a8d..11985687 100644 --- a/doc/manual/logging.md +++ b/doc/manual/logging.md @@ -10,6 +10,15 @@ A newly opened log file is not connected to any logging events. Some control over formatting will be provided at a later date. +## Appending to log files + + log.append_file "rtorrent.log", "/tmp/rtorrent.log" + +The `log.open_file` clears any existing contents of the file. If you'd +prefer to have a single log file that persists across application +restarts, you can use the `log.append_file` in place of the +`log.open_file` configuration key. + ## Adding outputs to events # log.add_output = "logging event", "log name"