From 6f5d79986a9c98b9cacc83f865fed957e4e6e4e6 Mon Sep 17 00:00:00 2001 From: Zbigniew Jędrzejewski-Szmek Date: Thu, 26 Nov 2015 16:32:41 -0500 Subject: core: rename Random* to RandomizedDelay* The name RandomSec is too generic: "Sec" just specifies the default unit type, and "Random" by itself is not enough. Rename to something that should give the user general idea what the setting does without looking at documentation. --- man/systemd.timer.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'man') diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml index fd03bda9cd..dcd7b90ee5 100644 --- a/man/systemd.timer.xml +++ b/man/systemd.timer.xml @@ -205,7 +205,7 @@ - RandomSec= + RandomizedDelaySec= Delay the timer by a randomly selected, evenly distributed amount of time between 0 and the specified time @@ -222,16 +222,16 @@ time range in order to minimize wakeups, the former does the opposite: it stretches timer events over a time range, to make it unlikely that they fire simultaneously. If - RandomSec= and + RandomizedDelaySec= and AccuracySec= are used in conjunction, first the a randomized time is added, and the result is then possibly shifted further to coalesce it with other timer events possibly happening on the system. As mentioned above AccuracySec= defaults to 1min and - RandomSec= to 0, thus encouraging + RandomizedDelaySec= to 0, thus encouraging coalescing of timer events. In order to optimally stretch timer events over a certain range of time, make sure to set - RandomSec= to a higher value, and + RandomizedDelaySec= to a higher value, and AccuracySec=1us. -- cgit v1.2.3-54-g00ecf From 20cc0ac7a036babd3bc9ff87e41dc937a7942931 Mon Sep 17 00:00:00 2001 From: Zbigniew Jędrzejewski-Szmek Date: Thu, 26 Nov 2015 16:44:59 -0500 Subject: man: remove repeated words in description of RandomizedDelay --- man/systemd.timer.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'man') diff --git a/man/systemd.timer.xml b/man/systemd.timer.xml index dcd7b90ee5..cfa13015b0 100644 --- a/man/systemd.timer.xml +++ b/man/systemd.timer.xml @@ -224,9 +224,9 @@ it unlikely that they fire simultaneously. If RandomizedDelaySec= and AccuracySec= are used in conjunction, first - the a randomized time is added, and the result is then - possibly shifted further to coalesce it with other timer - events possibly happening on the system. As mentioned above + the randomized delay is added, and then the result is + possibly further shifted to coalesce it with other timer + events happening on the system. As mentioned above AccuracySec= defaults to 1min and RandomizedDelaySec= to 0, thus encouraging coalescing of timer events. In order to optimally stretch -- cgit v1.2.3-54-g00ecf