docs/154070: [patch]Add /proc mount to Handbook GNOME desktop installation

[Warren Block]

>Number:         154070
>Category:       docs
>Synopsis:       [patch]Add /proc mount to Handbook GNOME desktop installation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jan 17 01:30:10 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Warren Block
>Release:        8-STABLE
>Organization:
>Environment:
FreeBSD lightning 8.2-PRERELEASE FreeBSD 8.2-PRERELEASE #0: Sat Jan 15 07:06:58 MST 2011     root at lightning:/usr/obj/usr/src/sys/LIGHTNING  i386
>Description:
The Handbook GNOME section does not mention the necessity of mounting /proc.  When /proc isn't mounted, GDM runs but shows no users.

The patch adds a note on /proc, and also breaks out the inline mentions of gdm_enable="YES" and gnome_enable="YES" to their own lines.  This makes them harder to lose in the flow of text.
>How-To-Repeat:
http://www.google.com/search?hl=en&source=hp&biw=1912&bih=1003&q=freebsd+gdm+no+users&aq=0&aqi=g3g-v7&aql=&oq=freebsd+gdm+
>Fix:
Patch attached.

Patch attached with submission follows:

--- chapter.sgml.orig	2011-01-16 17:48:29.000000000 -0700
+++ chapter.sgml	2011-01-16 18:19:52.000000000 -0700
@@ -1401,6 +1401,16 @@
         <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> requires
+          the <filename>/proc</filename> filesystem to be mounted.  Add</para>
+        
+        <programlisting>proc           /proc       procfs  rw  0   0
+          </programlisting>
+        
+        <para>to <filename>/etc/fstab</filename>, and
+          <filename>procfs</filename> will be mounted at system
+          startup.</para>
+          
         <para>Once <application>GNOME</application> is installed,
           the X server must be told to start
           <application>GNOME</application> instead of a default window
@@ -1409,17 +1419,22 @@
         <para>The easiest way to start
           <application>GNOME</application> is with
           <application>GDM</application>, the GNOME Display Manager.
-          <application>GDM</application>, which is installed as a part
-          of the <application>GNOME</application> desktop (but is
-          disabled by default), can be enabled by adding
-          <literal>gdm_enable="YES"</literal> to
-          <filename>/etc/rc.conf</filename>.  Once you have rebooted,
+          <application>GDM</application> is installed as a part
+          of the <application>GNOME</application> desktop but is
+          disabled by default.  It can be enabled by adding this line
+          to <filename>/etc/rc.conf</filename>:</para>
+        
+        <programlisting>gdm_enable="YES"</programlisting>
+        
+        <para>Once you have rebooted,
           <application>GDM</application> will start automatically.</para>
 
-	<para>Additionally, to enable all <application>GNOME</application>
-	  services when <application>GDM</application> starts, add 
-	  <literal>gnome_enable="YES"</literal> to 
-	  <filename>/etc/rc.conf</filename>.</para>
+	<para>It is often desirable to enable all
+	  <application>GNOME</application> services when
+	  <application>GDM</application> starts.  To do so, add this
+	  line to <filename>/etc/rc.conf</filename>:</para>
+	
+	<programlisting>gnome_enable="YES"</programlisting
 
         <para><application>GNOME</application> may also be started
 	  from the command-line by properly configuring a file named


>Release-Note:
>Audit-Trail:
>Unformatted: