diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 8b9994a46a..549f36af1d 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -590,7 +590,29 @@
RestartSteps=
Configures the number of exponential steps to take to increase the interval
of auto-restarts from RestartSec= to RestartMaxDelaySec=.
- Takes a positive integer or 0 to disable it. Defaults to 0.
+ Takes a positive integer or 0 to disable it. Defaults to 0. Hint: values
+ between 3 and 5 are good choices when exponential backoff is desired.
+
+ Example:
+
+ RestartSec=10s
+RestartSteps=4
+RestartMaxDelaySec=160s
+
+ This will produce the following restart intervals: 10s, 20s, 40s, 80s, 160s, 160s, 160s, etc.
+ Notice the geometric interpolation and the resulting constant ratio between intervals; here it is 2.
+ The formula for the ratio is
+
+
+ (RestartMaxDelaySec / RestartSec)^(1 / RestartSteps)
+
+ . A (repeating) delay equal to RestartMaxDelaySec= is always
+ reached after
+
+
+ RestartSteps + 1
+
+ steps.
This setting is effective only if RestartMaxDelaySec= is also set and
RestartSec= is not zero.