From: Lennart Poettering <lennart@poettering.net>
Date: Tue, 30 Oct 2012 23:19:34 +0000 (+0100)
Subject: man: explain a bit more detailed what happens on suspend
X-Git-Tag: v196~158
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=commitdiff_plain;h=630d4e14083fc3798b757604eb2055822b77608b

man: explain a bit more detailed what happens on suspend
---

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>