<!--
     The FreeBSD Documentation Project
     $FreeBSD$
-->

<chapter id="desktop">
  <chapterinfo>
    <authorgroup>
      <author>
        <firstname>Christophe</firstname>
        <surname>Juniet</surname>
        <contrib>Contributed by </contrib>
      </author>
    </authorgroup>
  </chapterinfo>

  <title>Desktop Applications</title>

  <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>Here are the categories covered by this chapter:</para>

    <itemizedlist>
      <listitem>
        <para>Browsers (such as <application>Mozilla</application>,
          <application>&netscape;</application>,
          <application>Opera</application>,
          <application>Firefox</application>,
	  <application>Konqueror</application>)</para>
      </listitem>

      <listitem>
        <para>Productivity (such as
          <application>KOffice</application>,
          <application>AbiWord</application>,
          <application>The GIMP</application>,
          <application>OpenOffice.org</application>)</para>
      </listitem>

      <listitem>
        <para>Document Viewers (such as <application>&acrobat.reader;</application>,
          <application>gv</application>,
          <application>Xpdf</application>,
          <application>GQview</application>)</para>
      </listitem>

      <listitem>
        <para>Finance (such as
          <application>GnuCash</application>,
          <application>Gnumeric</application>,
          <application>Abacus</application>)</para>
      </listitem>
    </itemizedlist>

    <para>Before reading this chapter, you should:</para>

    <itemizedlist>
      <listitem>
        <para>Know how to install additional third-party software
          (<xref linkend="ports">).</para>
      </listitem>

      <listitem>
        <para>Know how to install additional Linux software
	  (<xref linkend="linuxemu">).</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>
  </sect1>

  <sect1 id="desktop-browsers">
    <title>Browsers</title>

    <indexterm>
      <primary>browsers</primary>
      <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>If you are looking for light-weight browsers, you should
      investigate the Ports Collection for
      <filename role="package">www/dillo</filename>,
      <filename role="package">www/links</filename>, or
      <filename role="package">www/w3m</filename>.</para>

    <para>This section covers these applications:</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
        <thead>
          <row>
            <entry>Application Name</entry>
            <entry>Resources Needed</entry>
            <entry>Installation from Ports</entry>
            <entry>Major Dependencies</entry>
          </row>
        </thead>

        <tbody>
          <row>
            <entry><application>Mozilla</application></entry>
            <entry>heavy</entry>
            <entry>heavy</entry>
            <entry><application>Gtk+</application></entry>
          </row>

          <row>
            <entry><application>&netscape;</application></entry>
            <entry>heavy</entry>
            <entry>light</entry>
            <entry>Linux Binary Compatibility</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>
          </row>

          <row>
            <entry><application>Firefox</application></entry>
            <entry>medium</entry>
            <entry>heavy</entry>
            <entry><application>Gtk+</application></entry>
          </row>
          
	  <row>
	    <entry><application>Konqueror</application></entry>
	    <entry>medium</entry>
	    <entry>heavy</entry>
	    <entry><application>KDE</application> Libraries</entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    <sect2>
      <title>Mozilla</title>
      <indexterm>
	<primary><application>Mozilla</application></primary>
      </indexterm>

      <para><application>Mozilla</application> is perhaps the most
        suitable browser for your FreeBSD Desktop.  It is modern,
        stable, and fully ported to FreeBSD.  It features a very
        standards-compliant HTML display engine.  It provides a mail
        and news reader.  It even has a HTML composer if you plan to
        write some web pages yourself.  Users of
        <application>&netscape;</application> will recognize the
        similarities with <application>Communicator</application>
        suite, as both browsers shared the same basis.</para>

      <para>On slow machines, with a CPU speed less than 233MHz or
        with less than 64MB of RAM, <application>Mozilla</application>
        can be too resource-consuming to be fully usable.  You may
        want to look at the <application>Opera</application> browser
        instead, described a little later in this chapter.</para>

      <para>If you cannot or do not want to compile
        <application>Mozilla</application> for any reason, the FreeBSD
        GNOME team has already done this for you.  Just install the
        package from the network by:</para>

      <screen>&prompt.root; <userinput>pkg_add -r mozilla</userinput></screen>

      <para>If the package is not available, and you have enough time
        and disk space, you can get the source for
        <application>Mozilla</application>, compile it and install it
        on your system.  This is accomplished by:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/mozilla</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>The <application>Mozilla</application> port ensures a
        correct initialization by running the chrome registry setup
        with <username>root</username> privileges.  However, if you
        want to fetch some add-ons like mouse gestures, you must run
        <application>Mozilla</application> as
        <username>root</username> to get them properly
        installed.</para>

      <para>Once you have completed the installation of
        <application>Mozilla</application>, you do not need to be
        <username>root</username> any longer.  You can start
        <application>Mozilla</application> as a browser by typing:</para>

      <screen>&prompt.user; <userinput>mozilla</userinput></screen>

      <para>You can start it directly as a mail and news reader as
        shown below:</para>

      <screen>&prompt.user; <userinput>mozilla -mail</userinput></screen>
    </sect2>
    
    <sect2 id="moz-java-flash">
      <sect2info>
	<authorgroup>
	  <author>
	    <firstname>Tom</firstname>
	    <surname>Rhodes</surname>
	    <contrib>Contributed by </contrib>
	  </author>
	</authorgroup>
    </sect2info>

      <title>Mozilla, &java;, and &macromedia; &flash;</title>
      
      <para>Installing <application>Mozilla</application> is simple, but
	unfortunately installing <application>Mozilla</application> with
	support for add-ons like &java; and
	&macromedia; &flash;
	consumes both time and disk
	space.</para>

      <para>The first thing is to download the files which will be used
	with <application>Mozilla</application>.  Take your current web
	browser up to
	<ulink url="http://www.sun.com/software/java2/download.html"></ulink> and
	create an account on their website.  Remember to save the username
	and password from here as it may be needed in the future.  Download
	a copy of the file <filename>j2sdk-1_3_1-src.tar.gz</filename> and place this in
	<filename>/usr/ports/distfiles/</filename> as the port will not
	fetch it automatically.  This is due to license restrictions.  While
	we are here, download the <quote>java environment</quote> from
	<ulink url="http://java.sun.com/webapps/download/Display?BundleId=7905"></ulink>.
	The filename is <filename>j2sdk-1_3_1_08-linux-i586.bin</filename> and is large (about 25
	megabytes!).  Like before, this file must be placed into
	<filename>/usr/ports/distfiles/</filename>.  Finally download a copy
	of the <quote>java patchkit</quote> from
	<ulink url="http://www.eyesbeyond.com/freebsddom/java/"></ulink>
	and place it
	into <filename>/usr/ports/distfiles/</filename>.</para>
      
      <para>Install the <filename role="package">java/jdk13</filename> port
	with the standard <command>make install clean</command> and
	then install the <filename role="package">www/flashpluginwrapper</filename>
	port.  This port requires
	<filename role="package">emulators/linux_base</filename> which is a
	large port.  True that other <application>&flash;</application> plugins exist, however they have
	not worked for me.</para>

      <para>Install the <filename role="package">www/mozilla</filename> port,
	if <application>Mozilla</application> is not already installed.</para>

      <para>Now copy the <application>&flash;</application> plug-in files with:</para>
    
      <screen>&prompt.root; <userinput>cp /usr/local/lib/flash/libflashplayer.so \
	/usr/X11R6/lib/browser_plugins/libflashplayer_linux.so</userinput></screen>

      <screen>&prompt.root; <userinput>cp /usr/local/lib/flash/ShockwaveFlash.class \
	/usr/X11R6/lib/browser_plugins/</userinput></screen>

    <para>Now add the following lines to the top of (but right under
      <literal>#!/bin/sh</literal>) <application>Mozilla</application> startup script:
      <filename>/usr/X11R6/bin/mozilla</filename>.</para>

<programlisting>LD_PRELOAD=/usr/local/lib/libflashplayer.so.1
export LD_PRELOAD</programlisting>

      <para>This will enable the <application>&flash;</application> plug-in.</para>

      <para>Now just start <application>Mozilla</application> with:</para>

      <screen>&prompt.user; <userinput>mozilla &amp;</userinput></screen>

      <para>And access the <guimenuitem>About Plug-ins</guimenuitem> option from the
	<guimenu>Help</guimenu> menu.  A list should appear with all the currently
	available plugins.  <application>&java;</application> and
	<application>&shockwave; &flash;</application> should both be listed.</para>
    
    </sect2>

    <sect2>
      <title>&netscape;</title>
      <indexterm>
	<primary><application>Netscape</application></primary>
      </indexterm>

      <para>The Ports Collection contains several versions of the
        &netscape; browser.  Since the native FreeBSD ones contain a
        serious security bug, installing them is strongly
        discouraged.  Instead, use a more recent Linux or DIGITAL UNIX
        version.</para>

      <para>The latest stable release of the &netscape; browser is
        <application>&netscape; 7</application>.  It can be installed
        from the Ports Collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/netscape7</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <caution>
        <para><application>&netscape; 4.x</application> versions are not
          recommended because they are not compliant with today's
          standards.  However, <application>&netscape; 7.x</application>
          and newer versions are only available for the &i386;
          platform.</para>
      </caution>
    </sect2>

    <sect2>
      <title>Opera</title>
      <indexterm>
	<primary><application>Opera</application></primary>
      </indexterm>

      <para><application>Opera</application> is a very fast,
        full-featured, and standards-compliant browser.  It comes in
        two favors: a <quote>native</quote> FreeBSD version and a
        version that runs under Linux emulation.
	For each operating system, there is a no-cost version of the
        browser that displays advertising and an ad-free 
        version that can be purchased on the <ulink
        url="http://www.opera.com/">Opera web site</ulink>.</para>

      <para>To browse the Web with the FreeBSD version of <application>Opera</application>,
        install the package:</para>

      <screen>&prompt.root; <userinput>pkg_add -r opera</userinput></screen>

      <para>Some FTP sites do not have all the packages, but the same
        result can be obtained with the Ports Collection by
        typing:</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
	<literal>linux-opera</literal> in place of
	<literal>opera</literal> in the examples above.  The Linux
	version is useful in situations requiring the use of plug-ins
	that are only available for Linux, such as <application>Adobe
	&acrobat.reader;</application>.  In all other respects, the
	FreeBSD and Linux versions appear to be functionally
	identical.</para>

    </sect2>

    <sect2>
      <title>Firefox</title>
      <indexterm>
	<primary><application>Firefox</application></primary>
      </indexterm>

      <para><application>Firefox</application> is the next-generation
         browser based on the <application>Mozilla</application>
         codebase. <application>Mozilla</application> is a complete
         suite of applications, such as a browser, a mail client, a chat
         client and much more. <application>Firefox</application> is
         just a browser, which makes it smaller and faster.</para>

      <para>Install the package by typing:</para>

      <screen>&prompt.root; <userinput>pkg_add -r firefox</userinput></screen>

      <para>You can also use the Ports Collection if you
         prefer to compile from source code:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/www/firefox</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>
    <sect2>
      <title>Konqueror</title>
      <indexterm>
        <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 viewer.</para>

      <para><application>Konqueror</application> also comes with a set of plugins,
	available in <filename role="package">misc/konq-plugins</filename>.</para>

      <para><application>Konqueror</application> also supports <application>&flash;</application> and a How To
	is available at <ulink url="http://freebsd.kde.org/howto.php"></ulink>.</para>
    </sect2>
  </sect1>

  <sect1 id="desktop-productivity">
    <title>Productivity</title>

    <para>When it comes to productivity, new users often look for a
       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 application.  FreeBSD provides all that is
       needed, regardless of your desktop environment.</para>

    <para>This section covers these applications:</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
        <thead>
          <row>
            <entry>Application Name</entry>
            <entry>Resources Needed</entry>
            <entry>Installation from Ports</entry>
            <entry>Major Dependencies</entry>
          </row>
        </thead>

        <tbody>
          <row>
            <entry><application>KOffice</application></entry>
            <entry>light</entry>
            <entry>heavy</entry>
            <entry><application>KDE</application></entry>
          </row>

          <row>
            <entry><application>AbiWord</application></entry>
            <entry>light</entry>
            <entry>light</entry>
            <entry><application>Gtk+</application> or <application>GNOME</application></entry>
          </row>

          <row>
            <entry><application>The Gimp</application></entry>
            <entry>light</entry>
            <entry>heavy</entry>
            <entry><application>Gtk+</application></entry>
          </row>

          <row>
            <entry><application>OpenOffice.org</application></entry>
            <entry>heavy</entry>
            <entry>huge</entry>
            <entry><application>GCC 3.1</application>, <application>&jdk; 1.3</application>, <application>Mozilla</application></entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>
   
    <sect2>
      <title>KOffice</title>
      <indexterm>
	<primary><application>KOffice</application></primary>
      </indexterm>
      <indexterm>
	<primary>office suite</primary>
	<secondary><application>KOffice</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
        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> as a
        package, issue the following command:</para>

      <screen>&prompt.root; <userinput>pkg_add -r koffice</userinput></screen>

      <para>If the package is not available, you can use the ports
        collection.  For instance, to install
        <application>KOffice</application> for
        <application>KDE3</application>, do:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/editors/koffice-kde3</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>AbiWord</title>
      <indexterm>
	<primary><application>AbiWord</application></primary>
      </indexterm>

      <para><application>AbiWord</application> is a free word
        processing program similar in look and feel to <application>&microsoft; 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>

      <para><application>AbiWord</application> can import or export
        many file formats, including some proprietary ones like
        Microsoft <filename>.doc</filename>.</para>

      <para><application>AbiWord</application> is available as a
        package.  You can install it by:</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>

      <screen>&prompt.root; <userinput>cd /usr/ports/editors/abiword</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>The GIMP</title>
      <indexterm>
	<primary><application>The GIMP</application></primary>
      </indexterm>

      <para>For image authoring or picture retouching,
        <application>The GIMP</application> is a very 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.
        <application>The GIMP</application> can read and write a wide
        range of file formats.  It supports interfaces with scanners
        and tablets.</para>

      <para>You can install the package by issuing this
        command:</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>

      <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>
    </sect2>

    <sect2>
      <title>OpenOffice.org</title>
      <indexterm>
	<primary><application>OpenOffice.org</application></primary>
      </indexterm>
      <indexterm>
	<primary>office suite</primary>
	<secondary><application>OpenOffice.org</application></secondary>
      </indexterm>

      <para><application>OpenOffice.org</application> includes all of the
        mandatory applications in a complete office productivity
        suite: a word processor, a spreadsheet, a presentation manager,
        and a drawing program.  Its user interface is very similar
        to other office suites, and it can import and export in various
        popular file formats.  It is available in a number of
        different languages including interfaces, spell checkers, and
        dictionaries.</para>

      <para>The word processor of
        <application>OpenOffice.org</application> uses a native XML
        file format for increased portability and flexibility.  The
        spreadsheet program features a macro language and it can be
        interfaced with external databases.
        <application>OpenOffice.org</application> is already stable
        and runs natively on &windows;, &solaris;, Linux, FreeBSD,
        and &macos;&nbsp;X.  More
        information about <application>OpenOffice.org</application>
        can be found on the
	<ulink url="http://www.openoffice.org/">OpenOffice web site</ulink>.
	For FreeBSD specific information, and to directly
	download packages use the <ulink
	url="http://porting.openoffice.org/freebsd/">FreeBSD OpenOffice
	Porting Team</ulink>'s web site.</para>

      <para>To install <application>OpenOffice.org</application>,
        do:</para>

      <screen>&prompt.root; <userinput>pkg_add -r openoffice</userinput></screen>

      <note>
	<para>When running a -RELEASE version of &os;, this should work.
	  Otherwise, you should look on the &os; OpenOffice Porting Team's
	  web site to download and install the appropriate package
	  using &man.pkg.add.1;.  Both the current release and
	  development version are available for download at this
	  location.</para>
      </note>

      <para>Once the package is installed, you must run the setup
        program and choose a <option>standard workstation installation</option>.
        Run this command as the user who will use
        <application>OpenOffice.org</application>:</para>

      <screen>&prompt.user; <userinput>openoffice-setup</userinput></screen>

      <para>If the <application>OpenOffice.org</application> packages
        are not available, you still have the option to compile the
        port.  However, you must bear in mind that it requires a lot of
        disk space and a fairly long time to compile.</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/editors/openoffice-1.1</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>Once this is done, run the setup as the user who will use
        <application>OpenOffice.org</application> and choose a
        <option>standard workstation installation</option> by:</para>

      <screen>&prompt.user; <userinput>cd /usr/ports/editors/openoffice-1.1</userinput>
&prompt.user; <userinput>make install-user</userinput></screen>

      <para>If you want to use a localized version, here are the available
        ports:</para>

      <informaltable frame="none" pgwide="1">
        <tgroup cols="2">
          <colspec colwidth="1*">
          <colspec colwidth="2*">
          <thead>
            <row>
              <entry>Language</entry>
              <entry>Port</entry>
            </row>
          </thead>

          <tbody>
            <row>
              <entry>Catalan</entry>
              <entry><filename role="package">editors/openoffice-1.1-ca</filename></entry>
            </row>

            <row>
              <entry>Czech</entry>
              <entry><filename role="package">editors/openoffice-1.1-cs</filename></entry>
            </row>

            <row>
              <entry>Danish</entry>
              <entry><filename role="package">editors/openoffice-1.1-dk</filename></entry>
            </row>

            <row>
              <entry>Greek</entry>
              <entry><filename role="package">editors/openoffice-1.1-el</filename></entry>
            </row>

            <row>
              <entry>Spanish</entry>
              <entry><filename role="package">editors/openoffice-1.1-es</filename></entry>
            </row>

            <row>
              <entry>Estonian</entry>
              <entry><filename role="package">editors/openoffice-1.1-et</filename></entry>
            </row>

            <row>
              <entry>Finnish</entry>
              <entry><filename role="package">editors/openoffice-1.1-fi</filename></entry>
            </row>

            <row>
              <entry>Italian</entry>
              <entry><filename role="package">editors/openoffice-1.1-it</filename></entry>
            </row>

            <row>
              <entry>Dutch</entry>
              <entry><filename role="package">editors/openoffice-1.1-nl</filename></entry>
            </row>

            <row>
              <entry>Swedish</entry>
              <entry><filename role="package">editors/openoffice-1.1-se</filename></entry>
            </row>

            <row>
              <entry>Slovak</entry>
              <entry><filename role="package">editors/openoffice-1.1-sk</filename></entry>
            </row>

            <row>
              <entry>Slovenian</entry>
              <entry><filename role="package">editors/openoffice-1.1-sl_SI</filename></entry>
            </row>

            <row>
              <entry>Turkish</entry>
              <entry><filename role="package">editors/openoffice-1.1-tr</filename></entry>
            </row>

            <row>
              <entry>Arabic</entry>
              <entry><filename role="package">arabic/openoffice-1.1</filename></entry>
            </row>

            <row>
              <entry>Chinese (Simplified)</entry>
              <entry><filename role="package">chinese/openoffice-1.1-zh_CN</filename></entry>
            </row>

            <row>
              <entry>Chinese (Traditional)</entry>
              <entry><filename role="package">chinese/openoffice-1.1-zh_TW</filename></entry>
            </row>

            <row>
              <entry>French</entry>
              <entry><filename role="package">french/openoffice-1.1</filename></entry>
            </row>

            <row>
              <entry>German</entry>
              <entry><filename role="package">german/openoffice-1.1</filename></entry>
            </row>

            <row>
              <entry>Hungarian</entry>
              <entry><filename role="package">hungarian/openoffice-1.1</filename></entry>
            </row>

            <row>
              <entry>Japanese</entry>
              <entry><filename role="package">japanese/openoffice-1.1</filename></entry>
            </row>

            <row>
              <entry>Korean</entry>
              <entry><filename role="package">korean/openoffice-1.1</filename></entry>
            </row>
	    
            <row>
              <entry>Polish</entry>
              <entry><filename role="package">polish/openoffice-1.1</filename></entry>
            </row>
	    
            <row>
              <entry>Portuguese (Brazil)</entry>
              <entry><filename role="package">portuguese/openoffice-1.1-pt_BR</filename></entry>
            </row>

            <row>
              <entry>Portuguese</entry>
              <entry><filename role="package">portuguese/openoffice-1.1-pt_PT</filename></entry>
            </row>

            <row>
              <entry>Russian</entry>
              <entry><filename role="package">russian/openoffice-1.1</filename></entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </sect2>
  </sect1>

  <sect1 id="desktop-viewers">
    <title>Document Viewers</title>

    <para>Some new document formats have recently gained popularity.
      The standard viewers they require may not be available in the
      base system.  We will see how to install them in this
      section.</para>

    <para>This section covers these applications:</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
        <thead>
          <row>
            <entry>Application Name</entry>
            <entry>Resources Needed</entry>
            <entry>Installation from Ports</entry>
            <entry>Major Dependencies</entry>
          </row>
        </thead>

        <tbody>
          <row>
            <entry><application>&acrobat.reader;</application></entry>
            <entry>light</entry>
            <entry>light</entry>
            <entry>Linux Binary Compatibility</entry>
          </row>

          <row>
            <entry><application>gv</application></entry>
            <entry>light</entry>
            <entry>light</entry>
            <entry><application>Xaw3d</application></entry>
          </row>

          <row>
            <entry><application>Xpdf</application></entry>
            <entry>light</entry>
            <entry>light</entry>
            <entry><application>FreeType</application></entry>
          </row>

          <row>
            <entry><application>GQview</application></entry>
            <entry>light</entry>
            <entry>light</entry>
            <entry><application>Gtk+</application> or <application>GNOME</application></entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    <sect2>
      <title>&acrobat.reader;</title>
      <indexterm>
	<primary><application>Acrobat Reader</application></primary>
      </indexterm>
      <indexterm>
	<primary>PDF</primary>
	<secondary>viewing</secondary>
      </indexterm>

      <para>Many documents are now distributed as PDF files,
        which stands for <quote>Portable Document Format</quote>.  One
        of the recommended viewers for these types of files is
        <application>&acrobat.reader;</application>, released by Adobe
        for Linux.  As FreeBSD can run Linux binaries, it is also
        available for FreeBSD.</para>

      <para>To install the <application>&acrobat.reader; 5</application>
        package, do:</para>

      <screen>&prompt.root; <userinput>pkg_add -r acroread</userinput></screen>

      <para>As usual, if the package is not available or you want the
        latest version, you can use the Ports Collection as
        well:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/print/acroread5</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>gv</title>
      <indexterm>
	<primary><application>gv</application></primary>
      </indexterm>
      <indexterm>
	<primary>PDF</primary>
	<secondary>viewing</secondary>
      </indexterm>
      <indexterm>
	<primary>PostScript</primary>
	<secondary>viewing</secondary>
      </indexterm>

      <para><application>gv</application> is a &postscript; and PDF
        viewer.  It is originally based on
        <application>ghostview</application> but it has a nicer look
        thanks to the <application>Xaw3d</application> library.  It is fast and its interface is
        clean.  <application>gv</application> has many features like
        orientation, paper size, scale, or antialias.  Almost any
        operation can be done either from the keyboard or the
        mouse.</para>

      <para>To install <application>gv</application> as a package,
        do:</para>

      <screen>&prompt.root; <userinput>pkg_add -r gv</userinput></screen>

      <para>If you cannot get the package, you can use the ports
        collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/print/gv</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>Xpdf</title>
      <indexterm>
	<primary><application>Xpdf</application></primary>
      </indexterm>
      <indexterm>
	<primary>PDF</primary>
	<secondary>viewing</secondary>
      </indexterm>

      <para>If you want a small FreeBSD PDF viewer,
        <application>Xpdf</application> is a light-weight and
        efficient viewer.  It requires very few resources and is
        very stable.  It uses the standard X fonts and does not
        require <application>&motif;</application> or any other X toolkit.</para>

      <para>To install the <application>Xpdf</application> package,
        issue this command:</para>

      <screen>&prompt.root; <userinput>pkg_add -r xpdf</userinput></screen>

      <para>If the package is not available or you prefer to use the
        Ports Collection, do:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/xpdf</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>

      <para>Once the installation is complete, you can launch
        <application>Xpdf</application> and use the right mouse button
        to activate the menu.</para>
    </sect2>

    <sect2>
      <title>GQview</title>
      <indexterm>
	<primary><application>GQview</application></primary>
      </indexterm>

      <para><application>GQview</application> is an image manager.
        You can view a file with a single click, launch an external
        editor, get thumbnail previews, and much more.  It also
        features a slideshow mode and some basic file operations.  You
        can manage image collections and easily find duplicates.
        <application>GQview</application> can do full screen viewing
        and supports internationalization.</para>

      <para>If you want to install the
        <application>GQview</application> package, do:</para>

      <screen>&prompt.root; <userinput>pkg_add -r gqview</userinput></screen>

      <para>If the package is not available or you prefer to use the
        Ports Collection, do:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/graphics/gqview</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>
  </sect1>

  <sect1 id="desktop-finance">
    <title>Finance</title>

    <para>If, for any reason, you would like to manage your personal
      finances on your FreeBSD Desktop, there are some powerful and
      easy to use applications ready to be installed.  Some of them
      are compatible with widespread file formats like those of
      <application><trademark class="registered">Quicken</trademark></application> or <application>Excel</application> documents.</para>

    <para>This section covers these applications:</para>
     
    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
        <thead>
          <row>
            <entry>Application Name</entry>
            <entry>Resources Needed</entry>
            <entry>Installation from Ports</entry>
            <entry>Major Dependencies</entry>
          </row>
        </thead>

        <tbody>
          <row>
            <entry><application>GnuCash</application></entry>
            <entry>light</entry>
            <entry>heavy</entry>
            <entry><application>GNOME</application></entry>
          </row>

          <row>
            <entry><application>Gnumeric</application></entry>
            <entry>light</entry>
            <entry>heavy</entry>
            <entry><application>GNOME</application></entry>
          </row>

          <row>
            <entry><application>Abacus</application></entry>
            <entry>light</entry>
            <entry>light</entry>
            <entry><application>Tcl/Tk</application></entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>
   
    <sect2>
      <title>GnuCash</title>
      <indexterm>
	<primary><application>GnuCash</application></primary>
      </indexterm>

      <para><application>GnuCash</application> is part of the
        <application>GNOME</application> effort to provide
        user-friendly yet powerful applications to end-users.  With
        <application>GnuCash</application>, you can keep track of your
        income and expenses, your bank accounts, or your stocks.  It
        features an intuitive interface while remaining very
        professional.</para>

      <para><application>GnuCash</application> provides a smart
        register, a hierarchical system of accounts, many keyboard
        accelerators and auto-completion methods.  It can split a
        single transaction into several more detailed pieces.
        <application>GnuCash</application> can import and merge
        <application>Quicken</application> QIF files.  It also handles most international date
        and currency formats.</para>

      <para>To install <application>GnuCash</application> on your
        system, do:</para>

      <screen>&prompt.root; <userinput>pkg_add -r gnucash</userinput></screen>

      <para>If the package is not available, you can use the ports
        collection:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/finance/gnucash</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>Gnumeric</title>
      <indexterm>
	<primary><application>Gnumeric</application></primary>
      </indexterm>
      <indexterm>
	<primary>spreadsheet</primary>
	<secondary><application>Gnumeric</application></secondary>
      </indexterm>

      <para><application>Gnumeric</application> is a spreadsheet, part
        of the <application>GNOME</application> desktop environment.
        It features convenient automatic <quote>guessing</quote> of user
        input according to the cell format and an autofill system for
        many sequences.  It can import files in a number of popular
        formats like those of <application>Excel</application>, <application>Lotus 1-2-3</application>, or <application>Quattro Pro</application>.
        <application>Gnumeric</application> supports graphs through
        the <filename role="package">math/guppi</filename> graphing
        program.  It has a large number of built-in functions and
        allows all of the usual cell formats such as number, currency,
        date, time, and much more.</para>

      <para>To install <application>Gnumeric</application> as a
        package, type in:</para>

      <screen>&prompt.root; <userinput>pkg_add -r gnumeric</userinput></screen>

      <para>If the package is not available, you can use the ports
        collection by doing:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/math/gnumeric</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>

    <sect2>
      <title>Abacus</title>
      <indexterm>
	<primary><application>Abacus</application></primary>
      </indexterm>
      <indexterm>
	<primary>spreadsheet</primary>
	<secondary><application>Abacus</application></secondary>
      </indexterm>

      <para><application>Abacus</application> is a small and easy to
        use spreadsheet.  It includes many built-in functions useful
        in several domains such as statistics, finances, and
        mathematics.  It can import and export the <application>Excel</application> file format.
        <application>Abacus</application> can produce &postscript;
        output.</para>

      <para>To install <application>Abacus</application> from its
        package, do:</para>

      <screen>&prompt.root; <userinput>pkg_add -r abacus</userinput></screen>

      <para>If the package is not available, you can use the ports
        collection by doing:</para>

      <screen>&prompt.root; <userinput>cd /usr/ports/deskutils/abacus</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
    </sect2>
  </sect1>

  <sect1 id="desktop-summary">
    <title>Summary</title>

    <para>While FreeBSD is popular among ISPs for its performance and
      stability, it is quite ready for day-to-day use as a desktop.
      With several thousand applications available as
      <ulink url="http://www.FreeBSD.org/where.html">packages</ulink> or
      <ulink url="http://www.FreeBSD.org/ports/index.html">ports</ulink>,
      you can build a perfect desktop that suits all your needs.</para>

    <para>Once you have achieved the installation of your desktop, you
      may want to go one step further with
      <filename role="package">misc/instant-workstation</filename>.
      This <quote>meta-port</quote> allows you to build a typical set
      of ports for a workstation.  You can customize it by editing
      <filename>/usr/ports/misc/instant-workstation/Makefile</filename>.
      Follow the syntax used for the default set to add or remove
      ports, and build it with the usual procedure.
      Eventually, you will be able to create a big package that
      corresponds to your very own desktop and install it to your
      other workstations!</para>

    <para>Here is a quick review of all the desktop applications
      covered in this chapter:</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="3">
        <thead>
          <row>
            <entry>Application Name</entry>
	    <entry>Package Name</entry>
	    <entry>Ports Name</entry>
	  </row>
	</thead>

	<tbody>
	  <row>
            <entry><application>Mozilla</application></entry>
	    <entry><literal>mozilla</literal></entry>
	    <entry><filename role="package">www/mozilla</filename></entry>
	  </row>

	  <row>
            <entry><application>&netscape;</application></entry>
	    <entry><literal>linux-netscape7</literal></entry>
	    <entry><filename role="package">www/netscape7</filename></entry>
	  </row>

	  <row>
            <entry><application>Opera</application></entry>
	    <entry><literal>opera</literal></entry>
	    <entry><filename role="package">www/opera</filename></entry>
	  </row>

	  <row>
            <entry><application>Firefox</application></entry>
	    <entry><literal>firefox</literal></entry>
	    <entry><filename role="package">www/firefox</filename></entry>
	  </row>

	  <row>
            <entry><application>KOffice</application></entry>
	    <entry><literal>koffice-kde3</literal></entry>
	    <entry><filename role="package">editors/koffice-kde3</filename></entry>
	  </row>

	  <row>
            <entry><application>AbiWord</application></entry>
	    <entry><literal>abiword</literal></entry>
	    <entry><filename role="package">editors/abiword</filename></entry>
	  </row>

	  <row>
            <entry><application>The GIMP</application></entry>
	    <entry><literal>gimp</literal></entry>
	    <entry><filename role="package">graphics/gimp</filename></entry>
	  </row>

	  <row>
            <entry><application>OpenOffice.org</application></entry>
	    <entry><literal>openoffice</literal></entry>
	    <entry><filename role="package">editors/openoffice-1.1</filename></entry>
	  </row>

	  <row>
            <entry><application>&acrobat.reader;</application></entry>
	    <entry><literal>acroread</literal></entry>
	    <entry><filename role="package">print/acroread5</filename></entry>
	  </row>

	  <row>
            <entry><application>gv</application></entry>
	    <entry><literal>gv</literal></entry>
	    <entry><filename role="package">print/gv</filename></entry>
	  </row>

	  <row>
            <entry><application>Xpdf</application></entry>
	    <entry><literal>xpdf</literal></entry>
	    <entry><filename role="package">graphics/xpdf</filename></entry>
	  </row>

	  <row>
            <entry><application>GQview</application></entry>
	    <entry><literal>gqview</literal></entry>
	    <entry><filename role="package">graphics/gqview</filename></entry>
	  </row>

	  <row>
            <entry><application>GnuCash</application></entry>
	    <entry><literal>gnucash</literal></entry>
	    <entry><filename role="package">finance/gnucash</filename></entry>
	  </row>

	  <row>
            <entry><application>Gnumeric</application></entry>
	    <entry><literal>gnumeric</literal></entry>
	    <entry><filename role="package">math/gnumeric</filename></entry>
	  </row>

	  <row>
            <entry><application>Abacus</application></entry>
	    <entry><literal>abacus</literal></entry>
	    <entry><filename role="package">deskutils/abacus</filename></entry>
	  </row>
        </tbody>
      </tgroup>
    </informaltable>
  </sect1>
</chapter>

<!--
     Local Variables:
     mode: sgml
     sgml-declaration: "../chapter.decl"
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     sgml-parent-document: ("../book.sgml" "part" "chapter")
     End:
-->
