From nobody@FreeBSD.org  Mon Jan 17 01:27:28 2011
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 784B11065672
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 17 Jan 2011 01:27:28 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (unknown [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 5C7088FC08
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 17 Jan 2011 01:27:28 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id p0H1RSjA036746
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 17 Jan 2011 01:27:28 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id p0H1RSln036745;
	Mon, 17 Jan 2011 01:27:28 GMT
	(envelope-from nobody)
Message-Id: <201101170127.p0H1RSln036745@red.freebsd.org>
Date: Mon, 17 Jan 2011 01:27:28 GMT
From: Warren Block <wblock@wonkity.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch]Add /proc mount to Handbook GNOME desktop installation
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         154070
>Category:       docs
>Synopsis:       [patch]Add /proc mount to Handbook GNOME desktop installation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jan 17 01:30:10 UTC 2011
>Closed-Date:    Sat Feb 05 21:27:07 UTC 2011
>Last-Modified:  Sat Feb  5 21:30:08 UTC 2011
>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@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:
Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Mon Jan 17 01:56:47 UTC 2011 
Responsible-Changed-Why:  
I'll take this. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=154070 
State-Changed-From-To: open->closed 
State-Changed-By: gjb 
State-Changed-When: Sat Feb 5 21:26:50 UTC 2011 
State-Changed-Why:  
Committed, with minor changes.  Thanks! 


http://www.freebsd.org/cgi/query-pr.cgi?pr=154070 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/154070: commit references a PR
Date: Sat,  5 Feb 2011 21:26:07 +0000 (UTC)

 gjb         2011-02-05 21:26:02 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/x11 chapter.sgml 
   Log:
   Note that procfs(5) is necessary for proper GDM functionality.
   
   PR:             154070
   Submitted by:   Warren Block (wblock of wonkity com)
   Approved by:    jkois (mentor)
   
   Revision  Changes    Path
   1.206     +23 -9     doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
