diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 66c45e39a3..b31c087c76 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -305,8 +305,12 @@
really just halts the system rather than powering it
down.
- Applications wanting to halt the system should start
- this unit.
+ Applications wanting to halt the system should not start this unit
+ directly, but should instead execute systemctl halt
+ (possibly with the option) or call
+ systemd1's
+ org.freedesktop.systemd1.Manager.Halt D-Bus method
+ directly.
@@ -336,8 +340,12 @@
A special target unit for shutting down and rebooting
the system via kexec.
- Applications wanting to reboot the system with kexec
- should start this unit.
+ Applications wanting to reboot the system should not start this unit
+ directly, but should instead execute systemctl kexec
+ (possibly with the option) or call
+ systemd1's
+ org.freedesktop.systemd1.Manager.KExec D-Bus method
+ directly.
@@ -430,8 +438,12 @@
A special target unit for shutting down and powering
off the system.
- Applications wanting to power off the system should
- start this unit.
+ Applications wanting to reboot the system should not start this unit
+ directly, but should instead execute systemctl poweroff
+ (possibly with the option) or call
+ systemd-logind8's
+ org.freedesktop.login1.Manager.PowerOff D-Bus method
+ directly.runlevel0.target is an alias for
this target unit, for compatibility with SysV.
@@ -443,8 +455,12 @@
A special target unit for shutting down and rebooting
the system.
- Applications wanting to reboot the system should start
- this unit.
+ Applications wanting to reboot the system should not start this unit
+ directly, but should instead execute systemctl reboot
+ (possibly with the option) or call
+ systemd-logind8's
+ org.freedesktop.login1.Manager.Reboot D-Bus method
+ directly.runlevel6.target is an alias for
this target unit, for compatibility with SysV.