<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
  <!ENTITY koffice-download-http "http://mirrors.isc.org/pub/kde/stable/koffice-&koffice-version;/src/koffice-&koffice-version;.tar.bz2">
  <!ENTITY koffice-download-ftp  "ftp://ftp.kde.org/pub/kde/stable/koffice-&koffice-version;/src/koffice-&koffice-version;.tar.bz2">
  <!ENTITY koffice-md5sum        "386d388094734f9759977c3267098e30">
  <!ENTITY koffice-size          "55.0 MB">
  <!ENTITY koffice-buildsize     "489 MB (additional 592 MB for API docs)">
  <!ENTITY koffice-time          "44 SBU (additional 4.4 SBU for API docs)">
]>

<sect1 id="koffice" xreflabel="KOffice-&koffice-version;">
  <?dbhtml filename="koffice.html" ?>

  <sect1info>
    <othername>$LastChangedBy: andy $</othername>
    <date>$Date: 2012-02-17 09:43:28 -0500 (Fri, 17 Feb 2012) $</date>
  </sect1info>

  <title>KOffice-&koffice-version;</title>

  <indexterm zone="koffice">
    <primary sortas="a-KOffice">KOffice</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to KOffice</title>

    <para><application>KOffice</application> is the integrated office suite
    for <application>KDE</application>.  It provides native OASIS OpenDocument
    format support.</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&koffice-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&koffice-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &koffice-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &koffice-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &koffice-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &koffice-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>

    <para><application>KOffice</application> has many localization
    packages in the form of:
    <filename>koffice-l10n-<replaceable>&lt;xx&gt;</replaceable>-&koffice-version;.tar.bz2</filename>.
    The <replaceable>&lt;xx&gt;</replaceable> is a two to seven character code for the
    country covered. The sizes of these files range from about 0.2 MB to 15 MB. </para>

    <itemizedlist spacing='compact'>
      <listitem>
        <para><application>KOffice</application> l10n package listing: <ulink
        url="http://download.kde.org/stable/koffice-&koffice-version;/src/koffice-l10n/"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sums: <ulink
        url="http://mirrors.isc.org/pub/kde/stable/koffice-&koffice-version;/src/MD5SUMS"/></para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">KOffice Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="kdebase"/></para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended"><xref linkend="libjpeg"/>,
    <xref linkend="libart_lgpl"/>,
    <xref linkend="libxml2"/>, and
    <xref linkend="libxslt"/></para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="aspell"/>,
    <xref linkend="python2"/>,
    <xref linkend="ruby"/>,
    <ulink url="http://pqxx.org">libpqxx</ulink> (for kexi, requires <xref linkend="postgresql"/>),
    <xref linkend="mysql"/> (plugin),
    <xref linkend="lcms"/> and
    <xref linkend="imagemagick"/> (required for krita),
    <ulink url="http://www.openexr.com/">OpenEXR</ulink> (for enhanced image
    processing),
    <ulink url="http://sourceforge.net/projects/wvware/">libwv2</ulink> (for MS
    Word filter),
    <ulink url="http://libwpd.sourceforge.net/">libwpd</ulink> (for Wordperfect filter),
    <ulink
    url="http://packages.debian.org/unstable/source/libpaper">libpaper</ulink>,
    <xref linkend="graphviz"/>, and
    <xref linkend="doxygen"/> (the last two to build API documentation)</para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/koffice"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of KOffice</title>

    <para>Install <application>KOffice</application> with the following
    commands:</para>

<screen><userinput>./configure --prefix=$(kde-config --prefix) --disable-debug \
    --disable-dependency-tracking &amp;&amp;
make</userinput></screen>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
    href="../../xincludes/kde-apidocs.xml"/>

   <para>This package does not come with a test suite.</para>

   <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role='root'><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>karbon, kchart, kexi, kformula, kivio, koconverter,
        koshell, kplato, kprconverter.pl, kpresenter, krita,
        krossrunner, kspread, ksqlite, ksqlite2, ksqlite2to3,
        kthesaurus, kudesigner, kugar, and kword</seg>
        <seg>Numerous libraries (about 50) in $KDE_PREFIX/lib</seg>
        <seg>Numerous directories in $KDE_PREFIX/share</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="kchart">
        <term><command>kchart</command></term>
        <listitem>
          <para>is a chart drawing application.</para>
          <indexterm zone="koffice kchart">
            <primary sortas="b-kchart">kchart</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kexi">
        <term><command>kexi</command></term>
        <listitem>
          <para>is an integrated data management application.</para>
          <indexterm zone="koffice kexi">
            <primary sortas="b-kexi">kexi</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kformula">
        <term><command>kformula</command></term>
        <listitem>
          <para>is a formula editor.</para>
          <indexterm zone="koffice kformula">
            <primary sortas="b-kformula">kformula</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kivio">
        <term><command>kivio</command></term>
        <listitem>
          <para>is a flowchart program.</para>
          <indexterm zone="koffice kivio">
            <primary sortas="b-kivio">kivio</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kplato">
        <term><command>kplato</command></term>
        <listitem>
          <para>is a project management application.</para>
          <indexterm zone="koffice kplato">
            <primary sortas="b-klato">kplato</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kpresenter">
        <term><command>kpresenter</command></term>
        <listitem>
          <para>is a presentation builder/display program.</para>
          <indexterm zone="koffice kpresenter">
            <primary sortas="b-kpresenter">kpresenter</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="krita">
        <term><command>krita</command></term>
        <listitem>
          <para>is a painting and image editing application for KOffice..</para>
          <indexterm zone="koffice krita">
            <primary sortas="b-krita">krita</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kspread">
        <term><command>kspread</command></term>
        <listitem>
          <para>is a scriptable spreadsheet program.</para>
          <indexterm zone="koffice kspread">
            <primary sortas="b-kspread">kspread</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kugar">
        <term><command>kugar</command></term>
        <listitem>
          <para>is a tool for creating reports.</para>
          <indexterm zone="koffice kugar">
            <primary sortas="b-kugar">kugar</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="kword">
        <term><command>kword</command></term>
        <listitem>
          <para>is a framemaker-like word processing and desktop
          publishing program.</para>
          <indexterm zone="koffice kword">
            <primary sortas="b-kword">kword</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>
