svn commit: r40905 - head/en_US.ISO8859-1/books/handbook/desktop

Dru Lavigne dru at FreeBSD.org
Thu Feb 7 15:09:55 UTC 2013


Author: dru
Date: Thu Feb  7 15:09:55 2013
New Revision: 40905
URL: http://svnweb.freebsd.org/changeset/doc/40905

Log:
  This patch addresses the following:
  
  - fixes missing &os;, &linux; and incorrect <xref> tags
  
  - general rewording to replace "you" and address redundancy
  
  - removes deprecated apps: abacus, gimp-devel, guppi, konq-plugins and renames koffice to calligra
  
  - incorporates redundant summary into synopsis
  
  - fixes incorrect port/pkg names and adds localization notes where applicable
  
  - moves some <sect2> to <sect3> as they make more sense as subsections
  
  - rm openjdk compile as icedtea Makefile now does this for user
  
  - bumps up some pkg/port versions
  
  - adds some URLs to less known apps
  
  Approved by:  bcr (mentor)

Modified:
  head/en_US.ISO8859-1/books/handbook/desktop/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/desktop/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/desktop/chapter.xml	Thu Feb  7 15:05:37 2013	(r40904)
+++ head/en_US.ISO8859-1/books/handbook/desktop/chapter.xml	Thu Feb  7 15:09:55 2013	(r40905)
@@ -20,84 +20,188 @@
   <sect1 id="desktop-synopsis">
     <title>Synopsis</title>
 
-    <para>FreeBSD can run a wide variety of desktop applications, such
-      as browsers and word processors.  Most of these are available as
-      packages or can be automatically built from the Ports
-      Collection.  Many new users expect to find these kinds of
-      applications on their desktop.  This chapter will show you how
-      to install some popular desktop applications effortlessly,
-      either from their packages or from the Ports Collection.</para>
-
-    <para>Note that when installing programs from the ports, they are
-      compiled from source.  This can take a very long time, depending
-      on what you are compiling and the processing power of your
-      machine(s).  If building from source takes a prohibitively long
-      amount of time for you, you can install most of the programs of
-      the Ports Collection from pre-built packages.</para>
-
-    <para>As FreeBSD features Linux binary compatibility, many
-      applications originally developed for Linux are available for
-      your desktop.  It is strongly recommended that you read
-      <xref linkend="linuxemu"/> before installing any of the Linux
-      applications.  Many of the ports using the Linux binary
-      compatibility start with <quote>linux-</quote>.  Remember this
-      when you search for a particular port, for instance with
-      &man.whereis.1;.  In the following text, it is assumed that you
-      have enabled Linux binary compatibility before installing any of
-      the Linux applications.</para>
+    <para>While &os; is popular as a server for its performance and
+      stability, it is also suited for day-to-day use as a desktop.
+      With over 24,000 applications available as <link
+	linkend="packages-using">packages</link> or <link
+	linkend="ports-using">ports</link>, it is easy to build a
+      customized desktop that runs a wide variety of desktop
+      applications.  This chapter demonstrates how to install some
+      popular desktop applications effortlessly using packages or the
+      &os; Ports Collection.</para>
+
+    <para>As &os; features <link linkend="linuxemu">&linux; binary
+	compatibility</link>, many applications developed for &linux;
+      can be installed on a &os; desktop.  Many of the ports using
+      &linux; binary compatibility start with <quote>linux-</quote>.
+      This chapter assumes that &linux; binary compatibility has been
+      enabled before any &linux; applications are installed.</para>
 
-    <para>Here are the categories covered by this chapter:</para>
+    <para>This chapter demonstrates how to install the following
+      desktop applications:</para>
 
-    <itemizedlist>
-      <listitem>
-	<para>Browsers (such as <application>Firefox</application>,
-	  <application>Opera</application>,
-	  <application>Konqueror</application>,
-	  <application>Chromium</application>)</para>
-      </listitem>
+    <informaltable frame="none" pgwide="1">
+      <tgroup cols="3">
+	<thead>
+	  <row>
+	    <entry>Type of Application</entry>
+	    <entry>Application Name</entry>
+	    <entry>Package Name</entry>
+	    <entry>Ports Name</entry>
+	  </row>
+	</thead>
 
-      <listitem>
-	<para>Productivity (such as
-	  <application>KOffice</application>,
-	  <application>AbiWord</application>,
-	  <application>The GIMP</application>,
-	  <application>Apache OpenOffice</application>,
-	  <application>LibreOffice</application>)</para>
-      </listitem>
+	<tbody>
 
-      <listitem>
-	<para>Document Viewers (such as
-	  <application>&acrobat.reader;</application>,
-	  <application>gv</application>,
-	  <application>Xpdf</application>,
-	  <application>GQview</application>)</para>
-      </listitem>
+	  <row>
+	    <entry>Browser</entry>
+	    <entry><application>Firefox</application></entry>
+	    <entry><literal>firefox</literal></entry>
+	    <entry><filename
+		role="package">www/firefox</filename></entry>
+	  </row>
 
-      <listitem>
-	<para>Finance (such as
-	  <application>GnuCash</application>,
-	  <application>Gnumeric</application>,
-	  <application>Abacus</application>)</para>
-      </listitem>
-    </itemizedlist>
+	  <row>
+	    <entry>Browser</entry>
+	    <entry><application>Opera</application></entry>
+	    <entry><literal>opera</literal></entry>
+	    <entry><filename
+		role="package">www/opera</filename></entry>
+	  </row>
 
-    <para>Before reading this chapter, you should:</para>
+	  <row>
+	    <entry>Browser</entry>
+	    <entry><application>Konqueror</application></entry>
+	    <entry><literal>kde4-baseapps</literal></entry>
+	    <entry><filename
+		role="package">x11/kde4-baseapps</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Browser</entry>
+	    <entry><application>Chromium</application></entry>
+	    <entry><literal>chromium</literal></entry>
+	    <entry><filename
+		role="package">www/chromium</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Productivity</entry>
+	    <entry><application>Calligra</application></entry>
+	    <entry><literal>calligra</literal></entry>
+	    <entry><filename
+		role="package">editors/calligra</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Productivity</entry>
+	    <entry><application>AbiWord</application></entry>
+	    <entry><literal>abiword</literal></entry>
+	    <entry><filename
+		role="package">editors/abiword</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Productivity</entry>
+	    <entry><application>The GIMP</application></entry>
+	    <entry><literal>gimp</literal></entry>
+	    <entry><filename
+		role="package">graphics/gimp</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Productivity</entry>
+	    <entry><application>Apache
+		OpenOffice</application></entry>
+	    <entry><literal>openoffice</literal></entry>
+	    <entry><filename
+		role="package">editors/openoffice-3</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Productivity</entry>
+	    <entry><application>LibreOffice</application></entry>
+	    <entry><literal>libreoffice</literal></entry>
+	    <entry><filename
+		role="package">editors/libreoffice</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Document Viewer</entry>
+	    <entry><application>&acrobat.reader;</application></entry>
+	    <entry><literal>no package due to
+		license restriction</literal></entry>
+	    <entry><filename
+		role="package">print/acroread9</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Document Viewer</entry>
+	    <entry><application>gv</application></entry>
+	    <entry><literal>gv</literal></entry>
+	    <entry><filename
+		role="package">print/gv</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Document Viewer</entry>
+	    <entry><application>Xpdf</application></entry>
+	    <entry><literal>xpdf</literal></entry>
+	    <entry><filename
+		role="package">graphics/xpdf</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Document Viewer</entry>
+	    <entry><application>GQview</application></entry>
+	    <entry><literal>gqview</literal></entry>
+	    <entry><filename
+		role="package">graphics/gqview</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Finance</entry>
+	    <entry><application>GnuCash</application></entry>
+	    <entry><literal>gnucash</literal></entry>
+	    <entry><filename
+		role="package">finance/gnucash</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry>Finance</entry>
+	    <entry><application>Gnumeric</application></entry>
+	    <entry><literal>gnumeric</literal></entry>
+	    <entry><filename
+		role="package">math/gnumeric</filename></entry>
+	  </row>
+
+	  <row>
+	    <entry><application>KMyMoney</application></entry>
+	    <entry><literal>kmymoney-kde4</literal></entry>
+	    <entry><filename
+		role="package">finance/kmymoney-kde4</filename></entry>
+	  </row>
+	</tbody>
+      </tgroup>
+    </informaltable>
+
+    <para>Before reading this chapter, you should know how to:</para>
 
     <itemizedlist>
       <listitem>
-	<para>Know how to install additional third-party software
-	  (<xref linkend="ports"/>).</para>
+	<para>Install additional software using packages or
+	  ports.</para>
       </listitem>
 
       <listitem>
-	<para>Know how to install additional Linux software
-	  (<xref linkend="linuxemu"/>).</para>
+	<para>Enable &linux; binary compatibility.</para>
       </listitem>
     </itemizedlist>
 
-    <para>For information on how to get a multimedia environment, read
-      <xref linkend="multimedia"/>.  If you want to set up and use
-      electronic mail, please refer to <xref linkend="mail"/>.</para>
+    <para>For information on how to configure a multimedia
+      environment, refer to <link linkend="multimedia"></link>.  For
+      information on how to set up and use electronic mail, refer to
+      <link linkend="mail"></link>.</para>
   </sect1>
 
   <sect1 id="desktop-browsers">
@@ -108,26 +212,28 @@
       <secondary>web</secondary>
     </indexterm>
 
-    <para>FreeBSD does not come with a particular browser
-      pre-installed.  Instead, the
-      <ulink url="http://www.FreeBSD.org/ports/www.html">www</ulink>
-      directory of the Ports Collection contains a lot of browsers
-      ready to be installed.  If you do not have time to compile
-      everything (this can take a very long time in some cases) many
-      of them are available as packages.</para>
-
-    <para><application>KDE</application> and
-      <application>GNOME</application> already provide HTML browsers.
-      Please refer to <xref linkend="x11-wm"/> for more information on
-      how to set up these complete desktops.</para>
+    <para>&os; does not come with a pre-installed web browser.
+      Instead, the <ulink
+	url="http://www.FreeBSD.org/ports/www.html">www</ulink>
+      category of the Ports Collection contains many browsers which
+      can be installed as a package or compiled from the Ports
+      Collection.</para>
+
+    <para>The <application>KDE</application> and
+      <application>GNOME</application> desktop environments include
+      their own HTML browser.  Refer to <link linkend="x11-wm"></link>
+      for more information on how to set up these complete
+      desktops.</para>
 
-    <para>If you are looking for light-weight browsers, you should
-      investigate the Ports Collection for
+    <para>Some light-weight browsers include
       <filename role="package">www/dillo2</filename>,
-      <filename role="package">www/links</filename>, or
+      <filename role="package">www/links</filename>, and
       <filename role="package">www/w3m</filename>.</para>
 
-    <para>This section covers these applications:</para>
+    <para>This section demonstrates how to install the following
+      popular web browsers and indicates if the application is
+      resource-heavy, takes time to compile from ports, or has any
+      major dependencies.</para>
 
     <informaltable frame="none" pgwide="1">
       <tgroup cols="4">
@@ -136,7 +242,7 @@
 	    <entry>Application Name</entry>
 	    <entry>Resources Needed</entry>
 	    <entry>Installation from Ports</entry>
-	    <entry>Major Dependencies</entry>
+	    <entry>Notes</entry>
 	  </row>
 	</thead>
 
@@ -145,30 +251,30 @@
 	    <entry><application>Firefox</application></entry>
 	    <entry>medium</entry>
 	    <entry>heavy</entry>
-	    <entry><application>Gtk+</application></entry>
+	    <entry><application>&os; and &linux; versions are
+		available</application></entry>
 	  </row>
 
 	  <row>
 	    <entry><application>Opera</application></entry>
 	    <entry>light</entry>
 	    <entry>light</entry>
-	    <entry>FreeBSD and Linux versions available.  The Linux
-	      version depends on the Linux Binary Compatibility and
-	      <application>linux-openmotif</application>.</entry>
+	    <entry>&os; and &linux; versions are available</entry>
 	  </row>
 
 	  <row>
 	    <entry><application>Konqueror</application></entry>
 	    <entry>medium</entry>
 	    <entry>heavy</entry>
-	    <entry><application>KDE</application> Libraries</entry>
+	    <entry><application>Requires KDE</application>
+	      libraries</entry>
 	  </row>
 
 	  <row>
 	    <entry><application>Chromium</application></entry>
 	    <entry>medium</entry>
 	    <entry>medium</entry>
-	    <entry><application>Gtk+</application></entry>
+	    <entry><application>Requires Gtk+</application></entry>
 	  </row>
 	</tbody>
       </tgroup>
@@ -182,65 +288,62 @@
       </indexterm>
 
       <para><application>Firefox</application> is a modern, free,
-	open-source stable browser that is fully ported to &os;: it
-	features a very standards-compliant HTML display engine,
-	tabbed browsing, popup blocking, extensions, improved
-	security, and more.  <application>Firefox</application> is
-	based on the <application>Mozilla</application>
-	codebase.</para>
+	open source browser that is fully ported to &os;.  It
+	features a standards-compliant HTML display engine, tabbed
+	browsing, popup blocking, extensions, improved security, and
+	more.  <application>Firefox</application> is based on the
+	<application>Mozilla</application> codebase.</para>
 
-      <para>Install the package by typing:</para>
+      <para>Install the package of the latest release version of
+	<application>Firefox</application> by typing:</para>
 
       <screen>&prompt.root; <userinput>pkg_add -r firefox</userinput></screen>
 
-      <para>This will install the latest release version of
-	<application>Firefox</application>,
-	if you want to run <application>Firefox</application>
-	Extended Support Release (ESR) version, use instead:</para>
+      <para>To instead install <application>Firefox</application>
+	Extended Support Release (ESR) version, use:</para>
 
       <screen>&prompt.root; <userinput>pkg_add -r firefox-esr</userinput></screen>
 
-      <para>You can also use the Ports Collection if you
-	prefer to compile from source code:</para>
+      <para>Localized versions are available in <filename
+	  role="package">www/firefox-i18n</filename> and <filename
+	  role="package">www/firefox-esr-i18n</filename>.</para>
+
+      <para>The Ports Collection can instead be used to compile
+	the desired version of <application>firefox</application> from
+	source code.  This example builds <filename
+	  role="package">www/firefox</filename>, where
+	<literal>firefox</literal> can be replaced with the ESR or
+	localized version to install.</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/www/firefox</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-      <para>For <application>Firefox</application> ESR, in the
-	previous command replace <literal>firefox</literal> with
-	<literal>firefox-esr</literal>.</para>
-    </sect2>
-
-    <sect2 id="moz-java-plugin">
+    <sect3 id="moz-java-plugin">
       <title>Firefox and &java; Plugin</title>
 
       <note>
-	<para>In this section and in the next two sections, we assume
-	  you have already installed
-	  <application>Firefox</application>.</para>
+	<para>The following sections assume that
+	  <application>Firefox</application> is already
+	  installed.</para>
       </note>
 
-      <para>Install <application>OpenJDK 6</application>
-	through the Ports Collection by typing:</para>
-
-      <screen>&prompt.root; <userinput>cd /usr/ports/java/openjdk6</userinput>
-&prompt.root; <userinput>make install clean</userinput></screen>
-
-      <para>Then install the
-	<filename role="package">java/icedtea-web</filename>
-	port:</para>
+      <para><filename role="package">java/icedtea-web</filename>
+	provides a free software web browser plugin for running
+	Java applets.  It can be installed as a package.  To
+	alternately compile the port:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/java/icedtea-web</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-      <para>Make sure you have kept the default configuration options
-	for both ports.</para>
+      <para>Keep the default configuration options when compiling the
+	port.</para>
 
-      <para>Start your browser, enter <literal>about:plugins</literal>
-	in the location bar and press <keycap>Enter</keycap>.  A page
-	listing the installed plugins will be displayed; the
-	<application>&java;</application> plugin should be listed
-	there now.</para>
+      <para>Once installed, start <application>firefox</application>,
+	enter <literal>about:plugins</literal> in the location bar and
+	press <keycap>Enter</keycap>.  A page listing the installed
+	plugins will be displayed.  The
+	<application>&java;</application> plugin should be
+	listed.</para>
 
       <para>If the browser is unable to find the plugin, each user
 	will have to run the following command and relaunch the
@@ -248,9 +351,9 @@
 
       <screen>&prompt.user; <userinput>ln -s /usr/local/lib/IcedTeaPlugin.so \
   $HOME/.mozilla/plugins/</userinput></screen>
-    </sect2>
+    </sect3>
 
-    <sect2 id="moz-flash-plugin">
+    <sect3 id="moz-flash-plugin">
 
       <title>Firefox and &adobe; &flash; Plugin</title>
 
@@ -258,93 +361,90 @@
 	<primary>Flash</primary>
       </indexterm>
 
-      <para>The &adobe; &flash; plugin is not available for &os;.
-	However, a software layer (wrapper) for running the Linux
-	version of the plugin exists.  This wrapper also supports
-	&adobe; &acrobat; plugin, &realplayer; plugin and more.</para>
+      <para>A native &adobe; &flash; plugin is not available for &os;.
+	However, a software layer (wrapper) for running the &linux;
+	version of the plugin exists.  This wrapper also provides
+	support for other browser plugins such as &realplayer;.</para>
 
-      <para>According to the version of &os; you run various steps are
-	required:</para>
+      <para>The steps required to install and enable this plugin vary
+	by the &os; version:</para>
 
       <procedure>
 	<step>
 	  <title>Under &os; 7.X</title>
 
-	  <para>Install the
-	    <filename role="package">www/nspluginwrapper</filename>
-	    port.  This port requires <filename
+	  <para>Install the <filename
+	      role="package">www/nspluginwrapper</filename> package
+	    or port.  This application requires <filename
 	      role="package">emulators/linux_base-fc4</filename> which
 	    is a large port.</para>
 
-	  <para>The next step is to install the
-	    <filename role="package">www/linux-flashplugin9</filename>
-	    port.  This will install &flash; 9.X, this version is
-	    known to run correctly under &os; 7.X.</para>
+	  <para>Next, install <filename
+	      role="package">www/linux-flashplugin9</filename>.  This
+	    will install &flash; 9.X which is the version known to
+	    run correctly under &os; 7.X.</para>
 	</step>
 
 	<step>
 	  <title>Under &os; 8.X or Newer</title>
 
-	  <para>Install the
-	    <filename role="package">www/nspluginwrapper</filename>
-	    port.  This port requires <filename
+	  <para>Compile the <filename
+	      role="package">www/nspluginwrapper</filename> port.
+	    Due to licensing restrictions, a package is not available.
+	    This port requires <filename
 	      role="package">emulators/linux_base-f10</filename> which
 	    is a large port.</para>
 
-	  <para>The next step is to install &flash; 11.X from the
-	    <filename
+	  <para>Next, compile the <filename
 	      role="package">www/linux-f10-flashplugin11</filename>
-	    port.</para>
+	    port.  Due to licensing restrictions, a package is not
+	    available.</para>
 
-	  <para>This version will require the following link to be
-	    created:</para>
+	  <para>This version of &flash; requires the following link to
+	    be created:</para>
 
 	  <screen>&prompt.root; <userinput>ln -s /usr/local/lib/npapi/linux-f10-flashplugin/libflashplayer.so \
   /usr/local/lib/browser_plugins/</userinput></screen>
 
-	  <para>The <filename
+	  <para>Manually create <filename
 	      class="directory">/usr/local/lib/browser_plugins</filename>
-	    directory will have to be created manually if it does not
-	    exist on the system.</para>
+	    if it does not already exist on the system.</para>
 	</step>
       </procedure>
 
-      <para>Once the right &flash; port, according to the &os; version
-	you run,
-	is installed, the plugin must be installed by each
+      <para>Once the right &flash; port, according to the &os;
+	version, is installed, the plugin must be installed by each
 	user with <command>nspluginwrapper</command>:</para>
 
       <screen>&prompt.user; <userinput>nspluginwrapper -v -a -i</userinput></screen>
 
-      <para>Then, start your browser, enter
-	<literal>about:plugins</literal> in the location bar and press
-	<keycap>Enter</keycap>.
-	A list should appear with all the currently
-	available plugins.</para>
-    </sect2>
+      <para>Start the browser, enter <literal>about:plugins</literal>
+	in the location bar and press <keycap>Enter</keycap>.  A list
+	should appear with all the currently available plugins.</para>
+    </sect3>
 
-    <sect2 id="moz-swfdec-flash-plugin">
+    <sect3 id="moz-swfdec-flash-plugin">
       <title>Firefox and Swfdec &flash; Plugin</title>
 
       <para>Swfdec is the library for decoding and rendering &flash;
-	animations.  And Swfdec-Mozilla is a plugin for
+	animations.  Swfdec-Mozilla is a plugin for
 	<application>Firefox</application> browsers that uses the
 	Swfdec library for playing SWF files.  It is still in heavy
 	development.</para>
 
-      <para>If you cannot or do not want to compile it, just install
-	the package from the network:</para>
+      <para>To install the package:</para>
 
       <screen>&prompt.root; <userinput>pkg_add -r swfdec-plugin</userinput></screen>
 
-      <para>If the package is not available, you can compile and
-	install it from the Ports Collection:</para>
+      <para>If the package is not available, compile and install it
+	from the Ports Collection:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/www/swfdec-plugin</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-      <para>Then, restart your browser for this plugin taking
-	effect.</para>
+	<para>Restart the browser for this plugin to take
+	  effect.</para>
+      </sect3>
     </sect2>
 
     <sect2>
@@ -354,48 +454,48 @@
 	<primary><application>Opera</application></primary>
       </indexterm>
 
-      <para><application>Opera</application> is a
-	full-featured and standards-compliant browser.  It also
-	comes with a built-in mail and news reader, an IRC client,
-	an RSS/Atom feeds reader and much more.  Despite this,
-	<application>Opera</application> is relatively lightweight and
-	very fast. It comes in two flavors: a <quote>native</quote>
-	FreeBSD version and a version that runs under Linux
-	emulation.</para>
-
-      <para>To browse the Web with the FreeBSD version of
-	<application>Opera</application>, install the package:</para>
+      <para><application>Opera</application> is a full-featured and
+	standards-compliant browser which is still lightweight and
+	fast.  It comes with a built-in mail and news reader, an IRC
+	client, an RSS/Atom feeds reader, and more.  It is available
+	as a native &os; version and as a version that runs under
+	&linux; emulation.</para>
+
+      <para>This command installs the package of the &os; version of
+	<application>Opera</application>.  Replace
+	<literal>opera</literal> with <literal>linux-opera</literal>
+	to instead install the &linux; version.</para>
 
       <screen>&prompt.root; <userinput>pkg_add -r opera</userinput></screen>
 
-      <para>Some FTP sites do not have all the packages, but
-	<application>Opera</application> can still be obtained
-	through the Ports Collection by typing:</para>
+      <para>Alternately, install either version through the Ports
+	Collection.  This example compiles the native version:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/www/opera</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-      <para>To install the Linux version of
-	<application>Opera</application>, substitute
+      <para>To install the &linux; version, substitute
 	<literal>linux-opera</literal> in place of
-	<literal>opera</literal> in the example above.</para>
+	<literal>opera</literal>.</para>
 
-      <para>The &adobe; &flash; plugin is not available for &os;.
-	However, a &linux; version of the plugin exists.  To install
-	this version, the <filename
-	  role="package">www/linux-f10-flashplugin11</filename> port
-	has to be installed, then install the port <filename
-	  role="package">www/opera-linuxplugins</filename>:</para>
+      <para>To install &adobe; &flash; plugin support, first compile
+	the <filename
+	  role="package">www/linux-f10-flashplugin11</filename> port,
+	as a package is not available due to licensing restrictions.
+	Then install either the <filename
+	  role="package">www/opera-linuxplugins</filename> port
+	or package.  This example compiles both from ports:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/www/linux-f10-flashplugin11</userinput>
 &prompt.root; <userinput>make install clean</userinput>
 &prompt.root; <userinput>cd /usr/ports/www/opera-linuxplugins</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-      <para>You can check the presence of the plugin: start your
-	browser, enter <literal>opera:plugins</literal> in the
-	location bar and press <keycap>Enter</keycap>.  A list should
-	appear with all the currently available plugins.</para>
+      <para>Once installed, check the presence of the plugin by
+	starting the browser, entering
+	<literal>opera:plugins</literal> in the location bar and
+	pressing <keycap>Enter</keycap>.  A list should appear with
+	all the currently available plugins.</para>
 
       <para>To add the <application>&java;</application> plugin,
 	follow the <link linkend="moz-java-plugin">instructions for
@@ -409,32 +509,33 @@
 	<primary><application>Konqueror</application></primary>
       </indexterm>
 
-      <para><application>Konqueror</application> is part of
-	<application>KDE</application> but it can also be used outside
-	of <application>KDE</application> by installing
-	<filename role="package">x11/kdebase3</filename>.
-	<application>Konqueror</application> is much more than a
-	browser, it is also a file manager and a multimedia
+      <para><application>Konqueror</application> is part of <filename
+	  role="package">x11/kde4-baseapps</filename>.
+	<application>Konqueror</application> is more than a web
+	browser as it is also a file manager and a multimedia
 	viewer.</para>
 
-      <para>There is also a set of plugins available for
-	<application>Konqueror</application>, available in
-	<filename role="package">misc/konq-plugins</filename>.</para>
-
       <para><application>Konqueror</application> supports WebKit as
-	well as its own KHTML.  WebKit is used by many modern browsers
-	including Chromium.  To use WebKit with
-	<application>Konqueror</application> on &os;:</para>
+	well as its own KHTML.  WebKit is a rendering engine used by
+	many modern browsers including Chromium.  To use WebKit with
+	<application>Konqueror</application> on &os;, install
+	the <filename
+	  role="package">www/kwebkitpart</filename> package or
+	port.  This example compiles the port:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/www/kwebkitpart</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-      <para>Then in <application>Konqueror</application>, click
-	<quote>Settings</quote>, <quote>Configure Konqueror</quote>,
-	then <quote>Change KHTML to WebKit</quote>.</para>
+      <para>To enable WebKit within
+	<application>Konqueror</application>, click
+	<quote>Settings</quote>, <quote>Configure Konqueror</quote>.
+	In the <quote>General</quote> settings page, click the
+	drop-down menu next to <quote>Default web browser
+	engine</quote> and change <quote>KHTML</quote> to
+	<quote>WebKit</quote>.</para>
 
       <para><application>Konqueror</application> also supports
-	<application>&flash;</application>; a <quote>How To</quote>
+	<application>&flash;</application>.  A <quote>How To</quote>
 	guide for getting <application>&flash;</application> support
 	on <application>Konqueror</application> is available at <ulink
 	  url="http://freebsd.kde.org/howtos/konqueror-flash.php"></ulink>.</para>
@@ -447,12 +548,12 @@
 	<primary><application>Chromium</application></primary>
       </indexterm>
 
-      <para><application>Chromium</application> is an open-source
+      <para><application>Chromium</application> is an open source
 	browser project that aims to build a safer, faster, and more
 	stable web browsing experience.
 	<application>Chromium</application> features tabbed browsing,
 	popup blocking, extensions, and much more.
-	<application>Chromium</application> is the open-source project
+	<application>Chromium</application> is the open source project
 	upon which the Google Chrome web browser is based.</para>
 
       <para><application>Chromium</application> can be installed as a
@@ -467,34 +568,25 @@
 &prompt.root; <userinput>make install clean</userinput></screen>
 
       <note>
-	<para><application>Chromium</application> is installed as
-	  <filename>/usr/local/bin/chrome</filename>, not
+	<para>The executable for <application>Chromium</application>
+	  is <filename>/usr/local/bin/chrome</filename>, not
 	  <filename>/usr/local/bin/chromium</filename>.</para>
       </note>
-    </sect2>
 
-    <sect2 id="chromium-java-plugin">
+    <sect3 id="chromium-java-plugin">
       <title>Chromium and &java; Plugin</title>
 
       <note>
-	<para>This section assumes <application>Chromium</application>
-	  is already installed.</para>
+	<para>The following sections assume that
+	  <application>Chromium</application> is already
+	  installed.</para>
       </note>
 
-      <para>Install <application>OpenJDK 6</application> through
-	the Ports Collection by typing:</para>
+      <para>To install &java; plugin support, follow the instructions
+	in <link linkend="moz-java-plugin"></link>.</para>
 
-      <screen>&prompt.root; <userinput>cd /usr/ports/java/openjdk6
-&prompt.root; make install clean</userinput></screen>
-
-      <para>Next, install
-	<filename role="package">java/icedtea-web</filename> from the
-	Ports Collection:</para>
-
-      <screen>&prompt.root; <userinput>cd /usr/ports/java/icedtea-web
-&prompt.root; make install clean</userinput></screen>
-
-      <para>Start <application>Chromium</application>, and enter
+      <para>Once &java; support is installed, start
+	<application>Chromium</application>, and enter
 	<literal>about:plugins</literal> in the address bar.
 	IcedTea-Web should be listed as one of the installed
 	plugins.</para>
@@ -506,24 +598,18 @@
       <screen>&prompt.root; <userinput>mkdir -p /usr/local/share/chromium/plugins
 &prompt.root; ln -s /usr/local/lib/IcedTeaPlugin.so \
   /usr/local/share/chromium/plugins/</userinput></screen>
-    </sect2>
-
-    <sect2 id="chromium-flash-plugin">
-      <title>Chromium and &adobe; &flash; Plugin</title>
+      </sect3>
 
-      <note>
-	<para>This section assumes <application>Chromium</application>
-	  is already installed.</para>
-      </note>
+      <sect3 id="chromium-flash-plugin">
+	<title>Chromium and &adobe; &flash; Plugin</title>
 
-      <para>Configuring <application>Chromium</application> and
-	&adobe; &flash; is similar to the
-	<link linkend="moz-flash-plugin">instructions for
-	  Firefox</link>.  For more detailed instructions on
-	installing &adobe; &flash; on &os;, please refer to that
-	section.  No additional configuration should be necessary,
-	since <application>Chromium</application> is able to use some
-	plugins from other browsers.</para>
+	<para>Configuring <application>Chromium</application> and
+	  &adobe; &flash; is similar to the
+	  <link linkend="moz-flash-plugin">instructions for
+	  Firefox</link>.  No additional configuration should be
+	  necessary, since <application>Chromium</application> is able
+	  to use some plugins from other browsers.</para>
+      </sect3>
     </sect2>
   </sect1>
 
@@ -534,11 +620,14 @@
       good office suite or a friendly word processor.  While some
       <link linkend="x11-wm">desktop environments</link> like
       <application>KDE</application> already provide an office suite,
-      there is no default productivity package.  FreeBSD can provide
-      all that is needed, regardless of your desktop
-      environment.</para>
-
-    <para>This section covers these applications:</para>
+      there is no default productivity package.  Several office
+      suites and word processors are available for &os;, regardless
+      of the installed desktop environment.</para>
+
+    <para>This section demonstrates how to install the following
+      popular web browsers and indicates if the application is
+      resource-heavy, takes time to compile from ports, or has any
+      major dependencies.</para>
 
     <informaltable frame="none" pgwide="1">
       <tgroup cols="4">
@@ -553,7 +642,7 @@
 
 	<tbody>
 	  <row>
-	    <entry><application>KOffice</application></entry>
+	    <entry><application>Calligra</application></entry>
 	    <entry>light</entry>
 	    <entry>heavy</entry>
 	    <entry><application>KDE</application></entry>
@@ -579,7 +668,7 @@
 		OpenOffice</application></entry>
 	    <entry>heavy</entry>
 	    <entry>huge</entry>
-	    <entry><application>&jdk;</application>,
+	    <entry><application>&jdk;</application> and
 	      <application>Mozilla</application></entry>
 	  </row>
 
@@ -597,42 +686,37 @@
     </informaltable>
 
     <sect2>
-      <title>KOffice</title>
+      <title>Calligra</title>
 
       <indexterm>
-	<primary><application>KOffice</application></primary>
+	<primary><application>Calligra</application></primary>
       </indexterm>
       <indexterm>
 	<primary>office suite</primary>
-	<secondary><application>KOffice</application></secondary>
+	<secondary><application>Calligra</application></secondary>
       </indexterm>
 
-      <para>The KDE community has provided its desktop environment
-	with an office suite which can be used outside
-	<application>KDE</application>.  It includes the four standard
+      <para>The KDE community provides its desktop environment with
+	an office suite which can be used outside of
+	<application>KDE</application>.
+	<application>Calligra</application> includes standard
 	components that can be found in other office suites.
-	<application>KWord</application> is the word processor,
-	<application>KSpread</application> is the spreadsheet program,
-	<application>KPresenter</application> manages slide
-	presentations, and <application>Kontour</application> lets you
-	draw graphical documents.</para>
-
-      <para>Before installing the latest
-	<application>KOffice</application>, make sure you have an
-	up-to-date version of <application>KDE</application>.</para>
-
-      <para>To install <application>KOffice</application> for
-	<application>KDE4</application> as a
-	package, issue the following command:</para>
-
-      <screen>&prompt.root; <userinput>pkg_add -r koffice-kde4</userinput></screen>
-
-      <para>If the package is not available, you can use the Ports
-	Collection.  For instance, to install
-	<application>KOffice</application> for
-	<application>KDE4</application>, do:</para>
+	<application>Words</application> is the word processor,
+	<application>Sheets</application> is the spreadsheet program,
+	<application>Stage</application> manages slide presentations,
+	and <application>Karbon</application> is used to draw
+	graphical documents.</para>
+
+      <para><filename
+	  role="package">editors/calligra</filename> can be installed
+	as a package or a port.  To install the package:</para>
+
+      <screen>&prompt.root; <userinput>pkg_add -r calligra</userinput></screen>
+
+      <para>If the package is not available, use the Ports Collection
+	instead:</para>
 
-      <screen>&prompt.root; <userinput>cd /usr/ports/editors/koffice-kde4</userinput>
+      <screen>&prompt.root; <userinput>cd /usr/ports/editors/calligra</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
     </sect2>
 
@@ -647,21 +731,19 @@
 	processing program similar in look and feel to
 	<application>µsoft; Word</application>.  It is suitable
 	for typing papers, letters, reports, memos, and so forth.  It
-	is very fast, contains many features, and is very
-	user-friendly.</para>
+	is fast, contains many features, and is user-friendly.</para>
 
       <para><application>AbiWord</application> can import or export
 	many file formats, including some proprietary ones like
-	µsoft;'s <filename>.doc</filename>.</para>
+	µsoft; <filename>.doc</filename>.</para>
 
-      <para><application>AbiWord</application> is available as a
-	package.  You can install it by:</para>
+      <para>To install the <application>AbiWord</application>
+	package:</para>
 
       <screen>&prompt.root; <userinput>pkg_add -r abiword</userinput></screen>
 
       <para>If the package is not available, it can be compiled from
-	the Ports Collection.  The Ports Collection should be more
-	up to date.  It can be done as follows:</para>
+	the Ports Collection:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/editors/abiword</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
@@ -675,41 +757,29 @@
       </indexterm>
 
       <para>For image authoring or picture retouching,
-	<application>The GIMP</application> is a very sophisticated
+	<application>The GIMP</application> provides a sophisticated
 	image manipulation program.  It can be used as a simple paint
 	program or as a quality photo retouching suite.  It supports a
-	large number of plug-ins and features a scripting interface.
+	large number of plugins and features a scripting interface.
 	<application>The GIMP</application> can read and write a wide
-	range of file formats.  It supports interfaces with scanners
+	range of file formats and supports interfaces with scanners
 	and tablets.</para>
 
-      <para>You can install the package by issuing this
-	command:</para>
+      <para>To install the package:</para>
 
       <screen>&prompt.root; <userinput>pkg_add -r gimp</userinput></screen>
 
-      <para>If your FTP site does not have this package, you can use
-	the Ports Collection.  The <ulink
-	  url="http://www.FreeBSD.org/ports/graphics.html">graphics</ulink>
-	directory of the Ports Collection also contains
-	<application>The Gimp Manual</application>.  Here is how to
-	get them installed:</para>
+      <para>Alternately, use the Ports Collection:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/graphics/gimp</userinput>
-&prompt.root; <userinput>make install clean</userinput>
-&prompt.root; <userinput>cd /usr/ports/graphics/gimp-manual-pdf</userinput>
 &prompt.root; <userinput>make install clean</userinput></screen>
 
-      <note>
-	<para>The <ulink
-	    url="http://www.FreeBSD.org/ports/graphics.html">graphics</ulink>
-	  directory of the Ports Collection holds the development
-	  version of <application>The GIMP</application> in
-	  <filename role="package">graphics/gimp-devel</filename>.  An
-	  HTML version of <application>The Gimp Manual</application>
-	  is available from <filename
-	    role="package">graphics/gimp-manual-html</filename>.</para>
-      </note>
+      <para>The <ulink
+	  url="http://www.FreeBSD.org/ports/graphics.html">graphics</ulink>
+	category of the Ports Collection contains several
+	  <application>GIMP</application>-related plugins, help
+	files, and user manuals.</para>
+
     </sect2>
 
     <sect2>
@@ -727,105 +797,91 @@
 	</secondary>
       </indexterm>
 
-      <para>On 1 June 2011, Oracle Corporation donated the

*** DIFF OUTPUT TRUNCATED AT 1000 LINES ***


More information about the svn-doc-all mailing list