From 630d4e14083fc3798b757604eb2055822b77608b Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Wed, 31 Oct 2012 00:19:34 +0100
Subject: [PATCH] man: explain a bit more detailed what happens on suspend

---
 man/systemctl.xml               | 18 +++++++++++++++---
 man/systemd-suspend.service.xml |  5 +++++
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/man/systemctl.xml b/man/systemctl.xml
index 786c2bdfc..31f3b1a90 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -1173,17 +1173,29 @@
                         <varlistentry>
                                 <term><command>suspend</command></term>
 
-                                <listitem><para>Suspend the system.</para></listitem>
+                                <listitem><para>Suspend the
+                                system. This will trigger activation
+                                of the special
+                                <filename>suspend.target</filename>
+                                target.</para></listitem>
                         </varlistentry>
                         <varlistentry>
                                 <term><command>hibernate</command></term>
 
-                                <listitem><para>Hibernate the system.</para></listitem>
+                                <listitem><para>Hibernate the
+                                system. This will trigger activation
+                                of the special
+                                <filename>hibernate.target</filename>
+                                target.</para></listitem>
                         </varlistentry>
                         <varlistentry>
                                 <term><command>hybrid-sleep</command></term>
 
-                                <listitem><para>Hibernate and suspend the system.</para></listitem>
+                                <listitem><para>Hibernate and suspend
+                                the system. This will trigger
+                                activation of the special
+                                <filename>hybrid-sleep.target</filename>
+                                target.</para></listitem>
                         </varlistentry>
                         <varlistentry>
                                 <term><command>switch-root [ROOT] [INIT]</command></term>
diff --git a/man/systemd-suspend.service.xml b/man/systemd-suspend.service.xml
index b9464c882..9b8bad479 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
                 "<literal>systemctl suspend</literal>" or
                 similar.</para>
+
+                <para>Internally, this service will echo a string like
+                <literal>mem</literal> into
+                <filename>/sys/power/state</filename>, to trigger the
+                actual system suspend.</para>
         </refsect1>
 
         <refsect1>
-- 
2.30.2