From d15b1a6c225b40894953cde308b347cf99605f5f Mon Sep 17 00:00:00 2001
From: Lucas Werkmeister <mail@lucaswerkmeister.de>
Date: Fri, 15 Jan 2021 20:10:51 +0100
Subject: [PATCH] man: document that truncate:file happens per command line

---
 man/systemd.exec.xml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index 7328f9b9659..a3c641e1165 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -2425,8 +2425,12 @@ SystemCallErrorNumber=EPERM</programlisting>
         </para>
 
         <para><option>truncate:<replaceable>path</replaceable></option> is similar to
-        <option>file:<replaceable>path</replaceable></option> above, but it truncates the file when opening it.
-        </para>
+        <option>file:<replaceable>path</replaceable></option> above, but it truncates the file when opening
+        it. For units with multiple command lines, e.g. <varname>Type=oneshot</varname> services with
+        multiple <varname>ExecStart=</varname>, or services with <varname>ExecCondition=</varname>,
+        <varname>ExecStartPre=</varname> or <varname>ExecStartPost=</varname>, the output file is reopened
+        and therefore re-truncated for each command line. Any <varname>ExecReload=</varname> will likewise
+        truncate the file when run.</para>
 
         <para><option>socket</option> connects standard output to a socket acquired via socket activation. The
         semantics are similar to the same option of <varname>StandardInput=</varname>, see above.</para>
-- 
2.47.3