Date: Fri, 2 May 2014 16:57:25 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> 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 Message-ID: <201405021657.s42GvP1X048273@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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</scree <screen>&prompt.root; <userinput>pkg install gnome2</userinput></screen> <para>To instead build <application>GNOME</application> from - ports:</para> + ports, use the following command. + <application>GNOME</application> is a large application + and will take some time to compile, even on a fast + computer.</para> <screen>&prompt.root; <userinput>cd /usr/ports/x11/gnome2</userinput> &prompt.root; <userinput>make install clean</userinput></screen> @@ -1173,144 +1176,73 @@ DisplayManager.requestPort: 0</scree <indexterm><primary>KDE</primary></indexterm> - <para><application>KDE</application> is an easy to use - contemporary desktop environment. Some of the things that - <application>KDE</application> brings to the user - are:</para> - - <itemizedlist> - <listitem> - <para>A beautiful contemporary desktop</para> - </listitem> - - <listitem> - <para>A desktop exhibiting complete network - transparency</para> - </listitem> - - <listitem> - <para>An integrated help system allowing for convenient, - consistent access to help on the use of the - <application>KDE</application> desktop and its - applications</para> - </listitem> - - <listitem> - <para>Consistent look and feel of all - <application>KDE</application> applications</para> - </listitem> - - <listitem> - <para>Standardized menu and toolbars, keybindings, - color-schemes, etc.</para> - </listitem> - - <listitem> - <para>Internationalization: <application>KDE</application> - is available in more than 55 languages</para> - </listitem> - - <listitem> - <para>Centralized, consistent, dialog-driven desktop - configuration</para> - </listitem> + <para><application>KDE</application> 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 + <application>KDE</application> can be found at + <link xlink:href="http://www.kde.org/">http://www.kde.org/</link>. + For &os;-specific information, consult <link + xlink:href="http://freebsd.kde.org/">http://freebsd.kde.org</link>.</para>; - <listitem> - <para>A great number of useful - <application>KDE</application> applications</para> - </listitem> - </itemizedlist> - - <para><application>KDE</application> comes with a web - browser called <application>Konqueror</application>, which - is a solid competitor to other existing web browsers on - &unix; systems. More information on - <application>KDE</application> can be found on the - <link xlink:href="http://www.kde.org/">KDE website</link>. - For FreeBSD specific information and resources on - <application>KDE</application>, consult the - <link xlink:href="http://freebsd.kde.org/">KDE/FreeBSD - initiative</link>'s website.</para> - - <para>Just as with <application>GNOME</application> or any - other desktop environment, the software can be easily - installed from a package or the Ports Collection:</para> - - <para>To install the <application>KDE4</application> package, + <para>To install the <application>KDE</application> package, type:</para> <screen>&prompt.root; <userinput>pkg install x11/kde4</userinput></screen> - <para>To build <application>KDE</application> from source, - use the ports tree:</para> + <para>To instead build the <application>KDE</application> + port, use the following command. Installing the port will + provide a menu for selecting which components to + install. <application>KDE</application> is a large application + and will take some time to compile, even on a fast + computer.</para> <screen>&prompt.root; <userinput>cd /usr/ports/x11/kde4</userinput> &prompt.root; <userinput>make install clean</userinput></screen> - <para>The first time the port is installed, a menu will be - shown for selecting options. Accepting the defaults is - recommended.</para> - - <para><application>KDE 4</application> is a large application, - and will take quite some time to compile even on a fast - computer.</para> - - <para>After <application>KDE</application> 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 <filename>.xinitrc</filename> file:</para> - - <screen>&prompt.user; <userinput>echo "exec /usr/local/kde4/bin/startkde" > ~/.xinitrc</userinput></screen> - - <para>Now, whenever the X Window System is invoked with - <command>startx</command>, <application>KDE</application> - will be the desktop.</para> - - <para>If a display manager such as - <application>XDM</application> is being used, the - configuration is slightly different. Edit the - <filename>.xsession</filename> file instead. Instructions - for <application>KDM</application> are described later in - this chapter.</para> - - <para>Now that <application>KDE</application> 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.</para> - - <para>The best reference for <application>KDE</application> is - the on-line documentation. <application>KDE</application> - comes with its own web browser, - <application>Konqueror</application>, dozens of useful - applications, and extensive documentation. The remainder of - this section discusses the technical items that are difficult - to learn by random exploration.</para> - - <sect3 xml:id="x11-wm-kde-kdm"> - <title>The KDE Display Manager</title> - <indexterm> <primary>KDE</primary> <secondary>display manager</secondary> </indexterm> - <para>An administrator of a multi-user system may wish to have - a graphical login screen to welcome users. - <link linkend="x-xdm">XDM</link> can be used, as described - earlier. However, <application>KDE</application> includes - an alternative, <application>KDM</application>, 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 - (<application>KDE</application>, - <application>GNOME</application>, or something else) to run - after logging on.</para> - <para><application>KDE 4</application> requires that - &man.procfs.5; be mounted, and this line must be added to + <para><application>KDE</application> requires the + <filename>/proc</filename> file system to be mounted. Add + this line to <filename>/etc/fstab</filename> to mount this + file system automatically during system startup:</para> + + <programlisting>proc /proc procfs rw 0 0</programlisting> + + <para>The installation of <application>KDE</application> + includes the KDE Display Manager, + <application>KDM</application>. To enable this display + manager, add this line to <filename>/etc/rc.conf</filename>:</para> <programlisting>kdm4_enable="YES"</programlisting> - </sect3> + + <para>A second method for launching + <application>KDE</application> is to type + <command>startx</command> from the command line. For this + to work, the following line is needed in + <filename>~/.xinitrc</filename>:</para> + + <programlisting>exec /usr/local/kde4/bin/startkde</programlisting> + + <para>A third method for starting + <application>KDE</application> is through + <application>XDM</application>. To do so, create an + executable <filename>~/.xsession</filename> as + follows:</para> + + <screen>&prompt.user; <userinput>echo "#!/bin/sh" > ~/.xsession</userinput> +&prompt.user; <userinput>echo "/usr/local/kde4/bin/startkde" >> ~/.xsession</userinput> +&prompt.user; <userinput>chmod +x ~/.xsession</userinput></screen> + + <para>Once <application>KDE</application> is started, + refer to its built-in help system for more information on how + to use its various menus and applications.</para> </sect2> <sect2 xml:id="x11-wm-xfce"> @@ -1384,10 +1316,7 @@ DisplayManager.requestPort: 0</scree <application>XDM</application> is being used, create an <filename>.xsession</filename>, as described in <xref linkend="x11-wm-gnome"/>, but with the - <filename>/usr/local/bin/startxfce4</filename> command; or, - configure the display manager to allow choosing a desktop at - login time, as explained in - <xref linkend="x11-wm-kde-kdm"/>.</para> + <filename>/usr/local/bin/startxfce4</filename>.</para> </sect2> </sect1>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201405021657.s42GvP1X048273>