Add a patch to use the ConsoleKit2 API for Suspend and Hibernate in LXDE

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17276 af4574ff-66df-0310-9fd7-8a98e5e911e0

introduction/welcome/changelog.xml

@@ -46,6 +46,10 @@
     <listitem>
       <para>April 20th, 2016</para>
       <itemizedlist>
+        <listitem>
+          <para>[pierre] - Add a patch to Lxsession-0.5.2 to allow using
+          the ConsoleKit2 API for Suspend and Hibernate.</para>
+        </listitem>
         <listitem>
           <para>[bdubbs] - Update to phonon-4.9.0. Fixes 
           <ulink url="&blfs-ticket-root;7741">#7741</ulink>.</para>

lxde/desktop/lxsession.xml

@@ -70,13 +70,23 @@
       </listitem>
     </itemizedlist>
 
+    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Optional patch, which adds <quote>Hibernate</quote> and <quote>
+          Suspend</quote> capabilities through ConsoleKit2 API:
+          <ulink url="&patch-root;/lxsession-&lxsession-version;-hibernate_consolekit-2.patch"/>
+        </para>
+      </listitem>
+    </itemizedlist>
+
     <bridgehead renderas="sect3">LXSession Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
     <para role="required">
       <xref linkend="dbus-glib"/>,
-      <xref linkend="gtk2"/>,
-      <xref linkend="libunique"/> (used by lxpolkit and lxclipboard),
+      <xref linkend="libunique"/>,
       <xref linkend="lsb-release"/> (runtime for lxde-logout so it does not crash),
       <xref linkend="polkit"/>, and
       <xref linkend="vala"/>
@@ -84,11 +94,12 @@
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
+      <xref linkend="consolekit"/> (used at runtime by
+      <command>lxsession-logout</command>),
+      <xref linkend="gtk3"/>, and
       <xref linkend="libxslt"/> with
-      <xref linkend="DocBook"/>,
-      <xref linkend="docbook-xsl"/> (to build man pages), and
-      <xref linkend="upower"/> with
-      <xref linkend="pm-utils"/> (used by <command>lxsession-logout</command>)
+      <xref linkend="DocBook"/> and
+      <xref linkend="docbook-xsl"/> (to build man pages)
     </para>
 
     <para condition="html" role="usernotes">
@@ -99,6 +110,13 @@
   <sect2 role="installation">
     <title>Installation of LXSession</title>
 
+    <para>
+      Optionally apply the following patch to be able to put your system
+      into <quote>Suspend</quote> or <quote>Hibernate</quote> state.
+    </para>
+
+<screen><userinput>patch -Np1 -i ../lxsession-&lxsession-version;-hibernate_consolekit-2.patch</userinput></screen>
+
     <para>
       Install <application>LXSession</application> by running the following
       commands:
@@ -128,6 +146,12 @@ make</userinput></screen>
       and wish to build the manual pages.
     </para>
 
+    <para>
+      <option>--enable-gtk3</option>: Builds against <application>GTK+-3
+      </application> instead of <application>GTK+-2</application>, which
+      is required anyway by <application>libunique</application>.
+    </para>
+
   </sect2>
 
   <sect2 role="content">
@@ -273,7 +297,7 @@ make</userinput></screen>
         <term><command>lxsession-logout</command></term>
         <listitem>
           <para>
-            is a program that to logout from LXSession.
+            is a program to logout from LXSession.
           </para>
           <indexterm zone="lxsession lxsession-logout">
             <primary sortas="b-lxsession-logout">lxsession-logout</primary>