diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.sgml b/en_US.ISO8859-1/books/handbook/x11/chapter.sgml
index 8e658bcd00..026e4742e3 100644
--- a/en_US.ISO8859-1/books/handbook/x11/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/x11/chapter.sgml
@@ -1353,7 +1353,9 @@ DisplayManager.requestPort: 0
information regarding GNOME on
FreeBSD can be found on the FreeBSD GNOME
- Project's web site.
+ Project's web site. The web site also contains fairly
+ comprehensive FAQs about installing, configuring, and managing
+ GNOME.
@@ -1381,12 +1383,29 @@ DisplayManager.requestPort: 0
Once GNOME is installed,
the X server must be told to start
GNOME instead of a default window
- manager. If a custom .xinitrc is already in
+ manager.
+
+ The easiest way to start
+ GNOME is with
+ GDM, the GNOME Display Manager.
+ GDM, which is installed as a part
+ of the GNOME desktop (but is
+ disabled by default), can be enabled by adding
+ gdm_enable="YES" to
+ /etc/rc.conf. Once you have rebooted,
+ GNOME will start automatically
+ once you log in - no further configuration is
+ necessary.
+
+ GNOME may also be started
+ from the command-line by properly configuring a file named
+ .xinitrc.
+ If a custom .xinitrc is already in
place, simply replace the line that starts the current window
manager with one that starts
/usr/X11R6/bin/gnome-session instead.
- If nothing special has been done to configuration file,
- then it is enough to simply type:
+ If nothing special has been done to the configuration file,
+ then it is enough simply to type:
&prompt.user; echo "/usr/X11R6/bin/gnome-session" > ~/.xinitrc
@@ -1394,7 +1413,7 @@ DisplayManager.requestPort: 0
GNOME desktop environment will be
started.
- If a display manager, like
+ If an older display manager, like
XDM, is being used, this will not work.
Instead, create an executable .xsession
file with the same command in it. To do this, edit the file
@@ -1406,7 +1425,7 @@ DisplayManager.requestPort: 0
&prompt.user; echo "/usr/X11R6/bin/gnome-session" >> ~/.xsession
&prompt.user; chmod +x ~/.xsession
- Another option is to configure the display manager to
+ Yet another option is to configure the display manager to
allow choosing the window manager at login time; the section on
KDE details
explains how to do this for kdm, the