diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 76dfe60be4..b0aee3329f 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -754,7 +754,8 @@
limiting configured with StartLimitIntervalSec=
and StartLimitBurst=, see
systemd.unit5
- for details.
+ for details. A restarted service enters the failed state only
+ after the start limits are reached.
Setting this to is the
recommended choice for long-running services, in order to
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 5cd8be310d..445c26f3e5 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -665,7 +665,9 @@
A space-separated list of one or more units
that are activated when this unit enters the
- failed state.
+ failed state. A service unit using
+ Restart= enters the failed state only after
+ the start limits are reached.
diff --git a/man/systemd.xml b/man/systemd.xml
index 62ececb6e9..a881b392a7 100644
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -297,11 +297,12 @@
states are called "activating", "deactivating"). A special
"failed" state is available as well, which is very similar to
"inactive" and is entered when the service failed in some way
- (process returned error code on exit, or crashed, or an operation
- timed out). If this state is entered, the cause will be logged,
- for later reference. Note that the various unit types may have a
- number of additional substates, which are mapped to the five
- generalized unit states described here.
+ (process returned error code on exit, or crashed, an operation
+ timed out, or after too many restarts). If this state is entered,
+ the cause will be logged, for later reference. Note that the
+ various unit types may have a number of additional substates,
+ which are mapped to the five generalized unit states described
+ here.
The following unit types are available: