From e9a00ee34818262fcc56ca5da91286a17439112c Mon Sep 17 00:00:00 2001
From: Warren Block <wblock@FreeBSD.org>
Date: Wed, 27 Jan 2016 22:15:14 +0000
Subject: [PATCH] Add instructions on installing and enabling dbus and hal to
 the Gnome section.  Pointed out by forum user oldrancher.

---
 .../books/handbook/x11/chapter.xml            | 25 +++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.xml b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
index 41e3c6ded0..9eb30c611c 100644
--- a/en_US.ISO8859-1/books/handbook/x11/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/x11/chapter.xml
@@ -1412,14 +1412,35 @@ DisplayManager.requestPort:     0</screen>
       <screen>&prompt.root; <userinput>cd /usr/ports/x11/gnome2</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-      <para>For proper operation, <application>GNOME</application>
+      <para><application>GNOME</application>
 	requires <filename>/proc</filename> to be mounted.  Add this
 	line to <filename>/etc/fstab</filename> to mount this file
 	system automatically during system startup:</para>
 
       <programlisting>proc           /proc       procfs  rw  0   0</programlisting>
 
-      <para>Once <application>GNOME</application> is installed,
+      <para><application>GNOME</application> also needs
+	<application>D-Bus</application> and
+	<application>HAL</application>.  These applications provide a
+	message bus and hardware abstraction.  They can be installed
+	from packages:</para>
+
+      <screen>&prompt.root; <userinput>pkg install dbus hal</userinput></screen>
+
+      <para>or from the Ports Collection:</para>
+
+      <screen>&prompt.root; <userinput>cd /usr/ports/devel/dbus</userinput>
+&prompt.root; <userinput>make install clean</userinput>
+&prompt.root; <userinput>cd /usr/ports/sysutils/hal</userinput>
+&prompt.root; <userinput>make install clean</userinput></screen>
+
+      <para>Then enable both systems in
+	<filename>/etc/rc.conf</filename>:</para>
+
+      <programlisting>dbus_enable="YES"
+hald_enable="YES"</programlisting>
+
+      <para>After installation,
 	configure <application>&xorg;</application> to start
 	<application>GNOME</application>.  The easiest way to do this
 	is to enable the GNOME Display Manager,