docs/84713: [PATCH] Updates and tweaks to the GNOME part of the handbook's x11 thinger

[Adam Weinberger]

>Number:         84713
>Category:       docs
>Synopsis:       [PATCH] Updates and tweaks to the GNOME part of the handbook's x11 thinger
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 09 18:30:13 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Adam Weinberger
>Release:        FreeBSD 4.11-STABLE i386
>Organization:
pants!
>Environment:
System: FreeBSD freefall.freebsd.org 4.11-STABLE FreeBSD 4.11-STABLE #16: Sat Feb 26 00:02:03 GMT 2005 kensmith at freefall.freebsd.org:/c/src/sys/compile/FREEFALL i386


	
>Description:
	This patch adds a paragraph about enabling GDM, and notes that using GDM is the
	easiest way to start GNOME. It's also the easiest way to start KDE (less configgeration
	is neccessary) but I didn't mention that in the patch ;;-).

	The patch also fixes a few small grammar errors in the GNOME section and adds a few
	small clarity tweaks.
>How-To-Repeat:
	
>Fix:

	

--- x11-gnome-chapter.sgml.patch begins here ---
Index: chapter.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/x11/chapter.sgml,v
retrieving revision 1.165
diff -u -d -p -r1.165 chapter.sgml
--- chapter.sgml	28 Mar 2005 10:31:04 -0000	1.165
+++ chapter.sgml	9 Aug 2005 18:19:14 -0000
@@ -1353,7 +1353,9 @@ DisplayManager.requestPort:     0</scree
 	  information regarding <application>GNOME</application> on
 	  FreeBSD can be found on the <ulink
 	  url="http://www.FreeBSD.org/gnome">FreeBSD GNOME
-	  Project</ulink>'s web site.</para>
+	  Project</ulink>'s web site.  The website also contains fairly
+	  comprehensive FAQs about installing, configuring, and managing
+	  <application>GNOME</application>.</para>
       </sect3>
 
       <sect3 id="x11-wm-gnome-install">
@@ -1381,12 +1383,26 @@ DisplayManager.requestPort:     0</scree
         <para>Once <application>GNOME</application> is installed,
           the X server must be told to start
           <application>GNOME</application> instead of a default window
-          manager.  If a custom <filename>.xinitrc</filename> is already in
+          manager.</para>
+	  
+        <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>GNOME</application> will start automatically once you
+          log in - no further configuration is necessary.</para>
+
+        <para><application>GNOME</application> may also be started from the
+          command-line by properly configuring a file named
+          <filename>.xinitrc</filename>.
+          If a custom <filename>.xinitrc</filename> is already in
           place, simply replace the line that starts the current window
           manager with one that starts
           <application>/usr/X11R6/bin/gnome-session</application> instead.
-          If nothing special has been done to configuration file,
-          then it is enough to simply type:</para>
+          If nothing special has been done to the configuration file,
+          then it is enough simply to type:</para>
 
         <screen>&prompt.user; <userinput>echo "/usr/X11R6/bin/gnome-session" > ~/.xinitrc</userinput></screen>
 
@@ -1394,7 +1410,7 @@ DisplayManager.requestPort:     0</scree
           <application>GNOME</application> desktop environment will be
           started.</para>
 
-        <note><para>If a display manager, like
+        <note><para>If an older display manager, like
           <application>XDM</application>, is being used, this will not work.
           Instead, create an executable <filename>.xsession</filename>
           file with the same command in it.  To do this, edit the file
@@ -1406,7 +1422,7 @@ DisplayManager.requestPort:     0</scree
 &prompt.user; <userinput>echo "/usr/X11R6/bin/gnome-session" >> ~/.xsession</userinput>
 &prompt.user; <userinput>chmod +x ~/.xsession</userinput></screen>
 
-        <para>Another option is to configure the display manager to
+        <para>Yet another option is to configure the display manager to
           allow choosing the window manager at login time; the section on
           <link linkend="x11-wm-kde-details">KDE details</link>
           explains how to do this for <application>kdm</application>, the
--- x11-gnome-chapter.sgml.patch ends here ---


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