From owner-svn-doc-head@FreeBSD.ORG Fri May 2 15:30:24 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 148183D1; Fri, 2 May 2014 15:30:24 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id EADC41513; Fri, 2 May 2014 15:30:23 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s42FUNjT008611; Fri, 2 May 2014 15:30:23 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s42FUNNZ008610; Fri, 2 May 2014 15:30:23 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405021530.s42FUNNZ008610@svn.freebsd.org> From: Dru Lavigne Date: Fri, 2 May 2014 15:30:23 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44738 - head/en_US.ISO8859-1/books/handbook/x11 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 02 May 2014 15:30:24 -0000 Author: dru Date: Fri May 2 15:30:23 2014 New Revision: 44738 URL: http://svnweb.freebsd.org/changeset/doc/44738 Log: Editorial review of GNOME section. Fix some xrefs while here. More commits to this chapter to come. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/x11/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Fri May 2 05:37:53 2014 (r44737) +++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Fri May 2 15:30:23 2014 (r44738) @@ -521,9 +521,8 @@ dbus_enable="YES" not complete enough to serve as screen fonts. In addition, &xorg; can be configured to use &truetype; fonts with a minimum of effort. For more details - on this, see the &man.X.7; manual page or the section on &truetype; - fonts. + on this, see the &man.X.7; manual page or . To install the above Type1 font collections from the Ports Collection, run the following commands: @@ -551,9 +550,8 @@ dbus_enable="YES" ~/.xsession when logging in through a graphical login manager like XDM). A third way is to use the new - /usr/local/etc/fonts/local.conf file: see - the section on - anti-aliasing. + /usr/local/etc/fonts/local.conf file as demonstrated in + . @@ -597,8 +595,8 @@ dbus_enable="YES" &prompt.root; ttmkfdir -o fonts.dir Now add the &truetype; directory to the font path. This - is just the same as described above for Type1 fonts, that is, use + is just the same as described in : &prompt.user; xset fp+ /usr/local/lib/X11/fonts/TrueType &prompt.user; xset fp rehash @@ -1070,151 +1068,110 @@ DisplayManager.requestPort: 0 - - - --> - - Desktop Environments + - This section describes the different desktop environments - available for X on FreeBSD. A - desktop environment can mean anything ranging + This section describes how to install three popular + desktop environments on a &os; system. A + desktop environment can range from a simple window manager to a complete suite of desktop - applications, such as KDE or - GNOME. + applications. Over a hundred desktop environments are + available in the x11-wm category of the + Ports Collection. GNOME - - About GNOME - GNOME GNOME is a user-friendly - desktop environment that enables users to easily use and - configure their computers. GNOME - includes a panel (for starting applications and displaying - status), a desktop (where data and applications can be - placed), a set of standard desktop tools and applications, - anda set of conventions that make it easy for applications - to cooperate and be consistent with each other. Users of - other operating systems or environments should feel right at - home using the powerful graphics-driven environment that - GNOME provides. More information - regarding GNOME on FreeBSD can be - found on the FreeBSD GNOME - Project's web site. The web site also contains - fairly comprehensive FAQs about installing, configuring, and - managing GNOME. - - - - Installing GNOME + desktop environment. It + includes a panel for starting applications and displaying + status, a desktop, a set of tools and applications, + and a set of conventions that make it easy for applications + to cooperate and be consistent with each other. More information + regarding GNOME on &os; can be + found at http://www.FreeBSD.org/gnome. + That web site contains additional documentation + about installing, configuring, and + managing GNOME on &os;. - The software can be easily installed from a package - or the Ports Collection: - - To install the GNOME package, - type: + This desktop environment can be installed from a package: &prompt.root; pkg install gnome2 - To build GNOME from source, - use the ports tree: + To instead build GNOME from + ports: &prompt.root; cd /usr/ports/x11/gnome2 &prompt.root; make install clean For proper operation, GNOME - requires the /proc filesystem to be - mounted. Add + requires the /proc file system to be + mounted. Add this line to /etc/fstab to mount + this file system automatically during system + startup: proc /proc procfs rw 0 0 - to /etc/fstab to mount - &man.procfs.5; automatically during - startup. - Once GNOME is installed, - the X server must be told to start - GNOME instead of a default window - manager. - - The easiest way to start - GNOME is with - GDM, the GNOME Display Manager. - GDM is installed as part - of the GNOME desktop, although - it is disabled by default. It can be enabled by adding this + configure &xorg; to start + GNOME. The easiest way to do this + is to enable the GNOME Display Manager, + GDM, + which is installed as part + of the GNOME package or port. + It can be enabled by adding this line to /etc/rc.conf: gdm_enable="YES" - Once you have rebooted, GDM - will start automatically. - - It is often desirable to start all - GNOME services together with - GDM. To achieve this, add the - following line to /etc/rc.conf: + It is often desirable to also start all + GNOME services. To achieve this, add + a second line to /etc/rc.conf: gnome_enable="YES" - 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 + GDM + will now start automatically when the system boots. + + A second method for starting + GNOME is to type startx + from the command-line after configuring + ~/.xinitrc. If this file already exists, replace the line that starts the current window manager with one that starts - /usr/local/bin/gnome-session - instead. If nothing special has been done to the - configuration file, then it is enough simply to type: + /usr/local/bin/gnome-session. If + this file does not exist, create it with this command: &prompt.user; echo "/usr/local/bin/gnome-session" > ~/.xinitrc - Next, type startx, and the - GNOME desktop environment will - be started. - - - 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 and replace the existing - window manager command with - /usr/local/bin/gnome-session: - + A third method is to use + XDM as the display manager. In this case, + create an executable + ~/.xsession: &prompt.user; echo "#!/bin/sh" > ~/.xsession &prompt.user; echo "/usr/local/bin/gnome-session" >> ~/.xsession &prompt.user; chmod +x ~/.xsession - - 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 display manager of - KDE. - KDE KDE - - About KDE KDE is an easy to use contemporary desktop environment. Some of the things that @@ -1274,10 +1231,6 @@ DisplayManager.requestPort: 0KDE, consult the KDE/FreeBSD initiative's website. - - - - Installing KDE Just as with GNOME or any other desktop environment, the software can be easily @@ -1319,11 +1272,6 @@ DisplayManager.requestPort: 0.xsession file instead. Instructions for KDM are described later in this chapter. - - - - - More Details on KDE Now that KDE is installed on the system, most things can be discovered through the help @@ -1368,9 +1316,6 @@ DisplayManager.requestPort: 0 Xfce - - About Xfce - Xfce is a desktop environment based on the GTK+ toolkit used by GNOME, but is much more @@ -1416,10 +1361,6 @@ DisplayManager.requestPort: 0More information on Xfce can be found on the Xfce website. - - - - Installing Xfce To install Xfce, type: @@ -1441,13 +1382,12 @@ DisplayManager.requestPort: 0Xfce will be the desktop. As before, if a display manager like XDM is being used, create an - .xsession, as described in the section - on GNOME, but with the + .xsession, as described in + , but with the /usr/local/bin/startxfce4 command; or, configure the display manager to allow choosing a desktop at - login time, as explained in the section on - kdm. - + login time, as explained in + .