svn commit: r44739 - head/en_US.ISO8859-1/books/handbook/x11

Dru Lavigne dru at FreeBSD.org
Fri May 2 16:57:25 UTC 2014


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>
 


More information about the svn-doc-all mailing list