From owner-svn-doc-head@FreeBSD.ORG Fri May 2 16:57:25 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 C8D97678; Fri, 2 May 2014 16:57:25 +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 B50E6128C; Fri, 2 May 2014 16:57:25 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s42GvPOX048274; Fri, 2 May 2014 16:57:25 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s42GvP1X048273; Fri, 2 May 2014 16:57:25 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405021657.s42GvP1X048273@svn.freebsd.org> From: Dru Lavigne Date: Fri, 2 May 2014 16:57:25 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44739 - 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 16:57:25 -0000 Author: dru Date: Fri May 2 16:57:25 2014 New Revision: 44739 URL: http://svnweb.freebsd.org/changeset/doc/44739 Log: Editorial review of KDE section. 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 15:30:23 2014 (r44738) +++ head/en_US.ISO8859-1/books/handbook/x11/chapter.xml Fri May 2 16:57:25 2014 (r44739) @@ -1113,7 +1113,10 @@ DisplayManager.requestPort: 0&prompt.root; pkg install gnome2 To instead build GNOME from - ports: + ports, use the following command. + GNOME is a large application + and will take some time to compile, even on a fast + computer. &prompt.root; cd /usr/ports/x11/gnome2 &prompt.root; make install clean @@ -1173,144 +1176,73 @@ DisplayManager.requestPort: 0KDE - KDE is an easy to use - contemporary desktop environment. Some of the things that - KDE brings to the user - are: - - - - A beautiful contemporary desktop - - - - A desktop exhibiting complete network - transparency - - - - An integrated help system allowing for convenient, - consistent access to help on the use of the - KDE desktop and its - applications - - - - Consistent look and feel of all - KDE applications - - - - Standardized menu and toolbars, keybindings, - color-schemes, etc. - - - - Internationalization: KDE - is available in more than 55 languages - - - - Centralized, consistent, dialog-driven desktop - configuration - + KDE is another easy-to-use + desktop environment. This desktop provides a suite of + applications with a consistent look and feel, a standardized + menu and toolbars, keybindings, color-schemes, + internationalization, and a centralized, dialog-driven + desktop configuration. More information on + KDE can be found at + http://www.kde.org/. + For &os;-specific information, consult http://freebsd.kde.org. - - A great number of useful - KDE applications - - - - KDE comes with a web - browser called Konqueror, which - is a solid competitor to other existing web browsers on - &unix; systems. More information on - KDE can be found on the - KDE website. - For FreeBSD specific information and resources on - KDE, consult the - KDE/FreeBSD - initiative's website. - - Just as with GNOME or any - other desktop environment, the software can be easily - installed from a package or the Ports Collection: - - To install the KDE4 package, + To install the KDE package, type: &prompt.root; pkg install x11/kde4 - To build KDE from source, - use the ports tree: + To instead build the KDE + port, use the following command. Installing the port will + provide a menu for selecting which components to + install. KDE is a large application + and will take some time to compile, even on a fast + computer. &prompt.root; cd /usr/ports/x11/kde4 &prompt.root; make install clean - The first time the port is installed, a menu will be - shown for selecting options. Accepting the defaults is - recommended. - - KDE 4 is a large application, - and will take quite some time to compile even on a fast - computer. - - After KDE has been installed, - the X server must be told to launch this application - instead of the default window manager. This is accomplished - by editing the .xinitrc file: - - &prompt.user; echo "exec /usr/local/kde4/bin/startkde" > ~/.xinitrc - - Now, whenever the X Window System is invoked with - startx, KDE - will be the desktop. - - If a display manager such as - XDM is being used, the - configuration is slightly different. Edit the - .xsession file instead. Instructions - for KDM are described later in - this chapter. - - Now that KDE is installed on - the system, most things can be discovered through the help - pages, or just by pointing and clicking at various menus. - &windows; or &mac; users will feel quite at home. - - The best reference for KDE is - the on-line documentation. KDE - comes with its own web browser, - Konqueror, dozens of useful - applications, and extensive documentation. The remainder of - this section discusses the technical items that are difficult - to learn by random exploration. - - - The KDE Display Manager - KDE display manager - An administrator of a multi-user system may wish to have - a graphical login screen to welcome users. - XDM can be used, as described - earlier. However, KDE includes - an alternative, KDM, which is - designed to look more attractive and include more login-time - options. In particular, users can easily choose (via a - menu) which desktop environment - (KDE, - GNOME, or something else) to run - after logging on. - KDE 4 requires that - &man.procfs.5; be mounted, and this line must be added to + KDE 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 + + The installation of KDE + includes the KDE Display Manager, + KDM. To enable this display + manager, add this line to /etc/rc.conf: kdm4_enable="YES" - + + A second method for launching + KDE is to type + startx from the command line. For this + to work, the following line is needed in + ~/.xinitrc: + + exec /usr/local/kde4/bin/startkde + + A third method for starting + KDE is through + XDM. To do so, create an + executable ~/.xsession as + follows: + + &prompt.user; echo "#!/bin/sh" > ~/.xsession +&prompt.user; echo "/usr/local/kde4/bin/startkde" >> ~/.xsession +&prompt.user; chmod +x ~/.xsession + + Once KDE is started, + refer to its built-in help system for more information on how + to use its various menus and applications. @@ -1384,10 +1316,7 @@ DisplayManager.requestPort: 0XDM is being used, create an .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 - . + /usr/local/bin/startxfce4.