From af705eadd0486e8e5e7d547ef19a9bcad77a5da9 Mon Sep 17 00:00:00 2001 From: Dru Lavigne Date: Fri, 2 May 2014 15:30:23 +0000 Subject: [PATCH] Editorial review of GNOME section. Fix some xrefs while here. More commits to this chapter to come. Sponsored by: iXsystems --- .../books/handbook/x11/chapter.xml | 200 ++++++------------ 1 file changed, 70 insertions(+), 130 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/x11/chapter.xml b/en_US.ISO8859-1/books/handbook/x11/chapter.xml index 626729ca06..eb5e914f6c 100644 --- a/en_US.ISO8859-1/books/handbook/x11/chapter.xml +++ b/en_US.ISO8859-1/books/handbook/x11/chapter.xml @@ -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 + + + + Valentino + Vaschetto + + + + + + + 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. - + 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;. - - Installing GNOME - - 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: 0 KDE, 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: 0 More information on Xfce can be found on the Xfce website. - - - - Installing Xfce To install Xfce, type: @@ -1441,13 +1382,12 @@ DisplayManager.requestPort: 0 Xfce 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 + .