From d524094b6b3f968141af1a5a946be8e541dccbf5 Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Thu, 16 Jan 2020 16:47:56 +0100
Subject: [PATCH] man: underline that AccuracySec= is about coalescing timer
 events, nothing else

Fixes: #13328
---
 man/systemd.timer.xml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

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>
-- 
2.39.2