From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 16 Jan 2020 15:47:56 +0000 (+0100)
Subject: man: underline that AccuracySec= is about coalescing timer events, nothing else
X-Git-Tag: v245-rc1~109^2~7
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=d524094b6b3f968141af1a5a946be8e541dccbf5;p=thirdparty%2Fsystemd.git

man: underline that AccuracySec= is about coalescing timer events, nothing else

Fixes: #13328
---

diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml
index ebf6de4eb23..fca11b2d04c 100644
--- a/man/systemd.timer.xml
+++ b/man/systemd.timer.xml
@@ -225,7 +225,13 @@
         <citerefentry><refentrytitle>prctl</refentrytitle><manvolnum>2</manvolnum></citerefentry>
         for details. To optimize power consumption, make sure to set
         this value as high as possible and as low as
-        necessary.</para></listitem>
+        necessary.</para>
+
+        <para>Note that this setting is primarily a power saving option that allows coalescing CPU
+        wake-ups. It should not be confused with <varname>RandomizedDelaySec=</varname> (see below) which
+        adds a random value to the time the timer shall elapse next and whose purpose is the opposite: to
+        stretch elapsing of timer events over a longer period to reduce workload spikes. For further details
+        and explanations and how both settings play together, see below.</para></listitem>
       </varlistentry>
 
       <varlistentry>