diff --git a/man/systemd-system.conf.xml b/man/systemd-system.conf.xml
index fca9690092..1e49f88a8b 100644
--- a/man/systemd-system.conf.xml
+++ b/man/systemd-system.conf.xml
@@ -157,31 +157,27 @@
RuntimeWatchdogSec=
ShutdownWatchdogSec=
- Configure the hardware watchdog at runtime and
- at reboot. Takes a timeout value in seconds (or in other time
- units if suffixed with ms,
- min, h,
- d, w). If
- RuntimeWatchdogSec= is set to a non-zero
- value, the watchdog hardware
- (/dev/watchdog or the path specified with
- WatchdogDevice= or the kernel option
- systemd.watchdog-device=) will be programmed
- to automatically reboot the system if it is not contacted within
- the specified timeout interval. The system manager will ensure
- to contact it at least once in half the specified timeout
- interval. This feature requires a hardware watchdog device to
- be present, as it is commonly the case in embedded and server
- systems. Not all hardware watchdogs allow configuration of the
- reboot timeout, in which case the closest available timeout is
- picked. ShutdownWatchdogSec= may be used to
- configure the hardware watchdog when the system is asked to
- reboot. It works as a safety net to ensure that the reboot
- takes place even if a clean reboot attempt times out. By
- default RuntimeWatchdogSec= defaults to 0
- (off), and ShutdownWatchdogSec= to 10min.
- These settings have no effect if a hardware watchdog is not
- available.
+ Configure the hardware watchdog at runtime and at reboot. Takes a timeout value in seconds (or
+ in other time units if suffixed with ms, min, h,
+ d, w). If RuntimeWatchdogSec= is set to a non-zero
+ value, the watchdog hardware (/dev/watchdog or the path specified with
+ WatchdogDevice= or the kernel option systemd.watchdog-device=) will be
+ programmed to automatically reboot the system if it is not contacted within the specified timeout interval. The
+ system manager will ensure to contact it at least once in half the specified timeout interval. This feature
+ requires a hardware watchdog device to be present, as it is commonly the case in embedded and server
+ systems. Not all hardware watchdogs allow configuration of all possible reboot timeout values, in which case
+ the closest available timeout is picked. ShutdownWatchdogSec= may be used to configure the
+ hardware watchdog when the system is asked to reboot. It works as a safety net to ensure that the reboot takes
+ place even if a clean reboot attempt times out. Note that the ShutdownWatchdogSec= timeout
+ applies only to the second phase of the reboot, i.e. after all regular services are already terminated, and
+ after the system and service manager process (PID 1) got replaced by the systemd-shutdown
+ binary, see system bootup7
+ for details. During the first phase of the shutdown operation the system and service manager remains running
+ and hence RuntimeWatchdogSec= is still honoured. In order to define a timeout on this first
+ phase of system shutdown, configure JobTimeoutSec= and JobTimeoutAction=
+ in the [Unit] section of the shutdown.target unit. By default
+ RuntimeWatchdogSec= defaults to 0 (off), and ShutdownWatchdogSec= to
+ 10min. These settings have no effect if a hardware watchdog is not available.