diff --git a/man/bootup.xml b/man/bootup.xml
index 27619c29b8..565dda93cb 100644
--- a/man/bootup.xml
+++ b/man/bootup.xml
@@ -298,8 +298,18 @@ systemd-reboot.service systemd-poweroff.service systemd-halt.service syste
v v v v
reboot.target poweroff.target halt.target kexec.target
- Commonly used system shutdown targets are
- emphasized.
+ Commonly used system shutdown targets are emphasized.
+
+ Note that
+ systemsystemd-halt.service8,
+ systemd-reboot.service, systemd-poweroff.service and
+ systemd-kexec.service will transition the system and server manager (PID 1) into the second
+ phase of system shutdown (implemented in the systemd-shutdown binary), which will unmount any
+ remaining file systems, kill any remaining processes and release any other remaining resources, in a simple and
+ robust fashion, without taking any service or unit concept into account anymore. At that point, regular
+ applications and resources are generally terminated and released already, the second phase hence operates only as
+ safety net for everything that couldn't be stopped or released for some reason during the primary, unit-based
+ shutdown phase described above.
@@ -309,6 +319,7 @@ systemd-reboot.service systemd-poweroff.service systemd-halt.service syste
boot7,
systemd.special7,
systemd.target5,
+ systemd-halt.service8,
dracut8
diff --git a/man/systemd-halt.service.xml b/man/systemd-halt.service.xml
index b58279d828..a381b5c7d9 100644
--- a/man/systemd-halt.service.xml
+++ b/man/systemd-halt.service.xml
@@ -114,7 +114,8 @@
systemctl1,
systemd.special7,
reboot2,
- systemd-suspend.service8
+ systemd-suspend.service8,
+ bootup7