diff --git a/man/systemctl.xml b/man/systemctl.xml
index 786c2bdfcf..31f3b1a909 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -1173,17 +1173,29 @@
suspend
- Suspend the system.
+ Suspend the
+ system. This will trigger activation
+ of the special
+ suspend.target
+ target.
hibernate
- Hibernate the system.
+ Hibernate the
+ system. This will trigger activation
+ of the special
+ hibernate.target
+ target.
hybrid-sleep
- Hibernate and suspend the system.
+ Hibernate and suspend
+ the system. This will trigger
+ activation of the special
+ hybrid-sleep.target
+ target.
switch-root [ROOT] [INIT]
diff --git a/man/systemd-suspend.service.xml b/man/systemd-suspend.service.xml
index b9464c8826..9b8bad4791 100644
--- a/man/systemd-suspend.service.xml
+++ b/man/systemd-suspend.service.xml
@@ -106,6 +106,11 @@
system sleep states with a command such as
"systemctl suspend" or
similar.
+
+ Internally, this service will echo a string like
+ mem into
+ /sys/power/state, to trigger the
+ actual system suspend.