source: xsoft/office/libreoffice.xml@ 0c77b5ab

<?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 libreoffice-dl "http://download.documentfoundation.org/libreoffice/src/&libreoffice-version;">

  <!ENTITY libreoffice-core-download-http "&libreoffice-dl;/libreoffice-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-core-md5sum        "98674d57d6dd24baef38f007b5020e8e">
  <!ENTITY libreoffice-core-size          "118 MB">

  <!ENTITY libreoffice-dict-download-http "&libreoffice-dl;/libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-dict-md5sum        "c2b9d603b416d3efc11bf6dd3fc4d92e">
  <!ENTITY libreoffice-dict-size          "36 MB">

  <!ENTITY libreoffice-help-download-http "&libreoffice-dl;/libreoffice-help-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-help-md5sum        "8554bbbdfc72db998a191c71eeafdb55">
  <!ENTITY libreoffice-help-size          "1.8 MB">

  <!ENTITY libreoffice-translations-download-http "&libreoffice-dl;/libreoffice-translations-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-translations-md5sum        "4873b18cd8a535814777c8630fe2db9f">
  <!ENTITY libreoffice-translations-size          "122 MB">

  <!ENTITY libreoffice-buildsize          "4.0 GB (423 MB installed) -
                                           8.3 GB (537 MB installed), with translations">
  <!ENTITY libreoffice-time               "139 SBU - 177 SBU, with translations">
]>

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

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>LibreOffice-&libreoffice-version;</title>

  <indexterm zone="libreoffice">
    <primary sortas="a-LibreOffice">LibreOffice</primary>
  </indexterm>

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

    <para>
      <application>LibreOffice</application> is a full-featured office suite.
      It is largely compatible with <application>Microsoft Office</application>
      and is descended from <application>OpenOffice.org</application>.
    </para>

    &lfs75_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Core Download: <ulink url="&libreoffice-core-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Core Download MD5 sum: &libreoffice-core-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Core Download size: &libreoffice-core-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &libreoffice-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &libreoffice-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Dictionaries: <ulink url="&libreoffice-dict-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Dictionaries MD5 sum: &libreoffice-dict-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Dictionaries size: &libreoffice-dict-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Help Files: <ulink url="&libreoffice-help-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Help Files MD5 sum: &libreoffice-help-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Help Files size: &libreoffice-help-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Translations: <ulink url="&libreoffice-translations-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Translations MD5 sum: &libreoffice-translations-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Translations size: &libreoffice-translations-size;
        </para>
      </listitem>
    </itemizedlist>

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="gperf"/>,
      <xref linkend="perl-archive-zip"/>,
      <xref linkend="unzip"/>,
      <xref linkend="wget"/>,
      <xref linkend="which"/>, and
      <xref linkend="zip"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <note>
      <para>
        Most of these packages are recommended because if they're not installed,
        the build process will compile and install its own (often older)
        version.
      </para>
    </note>

    <para role="recommended">
      <xref linkend="libjpeg"/>,
      <xref linkend="glu"/>,
      <xref linkend="gtk2"/>,
      <xref linkend="boost"/>,
      <xref linkend="clucene"/>,
      <xref linkend="cups"/>,
      <xref linkend="curl"/>,
      <xref linkend="dbus"/>,
      <xref linkend="expat"/>,
      <xref linkend="graphite2"/>,
      <xref linkend="gst-plugins-base"/> or
      <xref linkend="gst10-plugins-base"/>,
      <xref linkend="harfbuzz"/>,
      <xref linkend="icu"/>,
      <xref linkend="lcms2"/>,
      <xref linkend="librsvg"/>,
      <xref linkend="libxml2"/> and
      <xref linkend="libxslt"/>,
      <xref linkend="mesalib"/>,
      <xref linkend="neon"/>,
      <xref linkend="npapi-sdk"/>,
      <xref linkend="nss"/>,
      <xref linkend="openldap"/> (client only),
      <xref linkend="openssl"/>,
      <xref linkend="poppler"/>,
      <xref linkend="python3"/> (used to build the translations),
      <xref linkend="redland"/>, and
      <xref linkend="unixodbc"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="avahi"/>,
      <xref linkend="bluez"/>,
      <xref linkend="doxygen"/> (not relevant if using --disable-odk),
      <ulink url="http://sourceforge.net/projects/cppunit/">Cppunit</ulink>,
      <xref linkend="gtk3"/>,
      <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
      <ulink url="http://sourceforge.net/projects/hunspell/files/Hyphen/">Hyphen</ulink>,
      <xref linkend="kdelibs"/>,
      <xref linkend="libatomic_ops"/>,
      <ulink url="http://libwpd.sourceforge.net/">libwpd</ulink>,
      <ulink url="http://libwpg.sourceforge.net/">libwpg</ulink>,
      <ulink url="http://libwps.sourceforge.net/">libwps</ulink>,
      <ulink url="http://www.freedesktop.org/wiki/Software/libcdr/">libcdr</ulink>,
      <ulink url="http://www.freedesktop.org/wiki/Software/libmspub/">libmspub</ulink>,
      <ulink url="http://sourceforge.net/projects/libmwaw/">libmwaw</ulink>,
      <ulink url="http://www.freedesktop.org/wiki/Software/libvisio/">libvisio</ulink>,
      <ulink url="http://sourceforge.net/projects/libcmis/">libcmis</ulink>,
      <ulink url="http://www.freedesktop.org/wiki/Software/libexttextcat/">libexttextcat</ulink>,
      <ulink url="http://tagoh.bitbucket.org/liblangtag/">liblangtag</ulink>,
      <ulink url="http://sourceforge.net/projects/libwpd/files/libodfgen/">libodfgen</ulink>,
      <ulink url="http://hci.iwr.uni-heidelberg.de/vigra/">VIGRA</ulink>,
      <ulink url="http://code.google.com/p/multidimalgorithm/">mdds</ulink>,
      <xref linkend="mariadb"/> or <xref linkend="mysql"/>,
      <ulink url="http://sourceforge.net/projects/hunspell/files/MyThes/">MyThes</ulink>,
      <ulink url="https://gitorious.org/orcus">Orcus</ulink>,
      <xref linkend="postgresql"/>,
      <xref linkend="mitkrb"/>,
      <ulink url="http://lpsolve.sourceforge.net/">lp_solve</ulink>,
      <xref linkend="sane"/>,
      <xref linkend="vlc"/>, and
      <ulink url="&gnome-download-http;/zenity/">Zenity</ulink>
    </para>

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

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

    <warning>
      <para>
        Untaring the libreoffice-&libreoffice-dlversion; tarball as
        <systemitem class="username">root</systemitem> has the curious effect of
        changing the ownership of the <emphasis>parent</emphasis> directory
        to a user with numerical id 11012 and with the permissions set to allow
        read, write and execute for that user only! If you untared as
        <systemitem class="username">root</systemitem> in your home folder you
        could end up unable to log in again. If you untared it in
        <filename class="directory">/usr</filename> you would find your user
        account unable to access any file in
        <filename class="directory">/usr</filename>.
      </para>

      <para>
        You can avoid this unpleasantness by
        <emphasis>not</emphasis> untaring it as
        <systemitem class="username">root</systemitem>. If you must untar it as
        <systemitem class="username">root</systemitem> pass the option
        <option>--no-overwrite-dir</option> to tar. This is the default when you
        untar as a user but has to be passed as an option when untaring as
        <systemitem class="username">root</systemitem>:
      </para>
    </warning>

<screen role="root"><userinput>tar -xf libreoffice-&libreoffice-dlversion;.tar.xz --no-overwrite-dir &amp;&amp;
cd libreoffice-&libreoffice-dlversion;</userinput></screen>

    <para>
      Unpack the dictionaries file and create symlinks to tarballs from the
      source directory so they won't get downloaded again (it is not necessary
      to unpack the help nor the translations tarballs):
    </para>

<screen><userinput>install -dm755 src &amp;&amp;

tar -xf ../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz --no-overwrite-dir --strip-components=1 &amp;&amp;
<!-- Not necessary for this version
tar -xf ../libreoffice-help-&libreoffice-dlversion;.tar.xz -\-no-overwrite-dir -\-strip-components=1 &amp;&amp;
-->
ln -sv ../../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz src/ &amp;&amp;
ln -sv ../../libreoffice-help-&libreoffice-dlversion;.tar.xz src/</userinput></screen>

<!-- Not necessary for this version
    <para>
      If you have downloaded the translations tarball, unpack it:
    </para>

<screen><userinput>tar -xf ../libreoffice-translations-&libreoffice-dlversion;.tar.xz -\-no-overwrite-dir -\-strip-components=1 &amp;&amp;
ln -sv ../../libreoffice-translations-&libreoffice-dlversion;.tar.xz src/</userinput></screen>
-->
    <para>
      If you have downloaded the translations tarball, create a symlink:
    </para>

<screen><userinput>ln -sv ../../libreoffice-translations-&libreoffice-dlversion;.tar.xz src/</userinput></screen>

    <note>
      <para>
        During the build process, some packages will be downloaded (including
        the ones listed as recommended and optional dependencies) if they are
        not present on the system. Doing so, build time may be different
        for everyone.
      </para>
    </note>

    <para>
      In the rest of the page, locales "en-US" and "pt-BR" are examples; you
      can change them to suit your needs - you might want to read the
      "Command Explanations", further below, before proceeding.
    </para>
    
    <para>
      Due to the large size of the package, you may prefer to install it in
      <filename class="directory">/opt</filename>, instead of
      <filename class="directory">/usr</filename>. Depending on your choice,
      replace <replaceable>&lt;PREFIX&gt;</replaceable> by
      <filename class="directory">/usr</filename> or by
      <filename class="directory">/opt/libreoffice-&libreoffice-dlversion;</filename>:
    </para>

<screen><userinput>export LO_PREFIX=<replaceable>&lt;PREFIX&gt;</replaceable></userinput></screen>
    
    <para>
      Prepare <application>LibreOffice</application> for compilation by running
      the following commands:
    </para>

<screen><userinput>sed -e "/gzip -f/d"   \
    -e "s|.1.gz|.1|g" \
    -i bin/distro-install-desktop-integration        &amp;&amp;
sed -e "/distro-install-file-lists/d" -i Makefile.in &amp;&amp;

chmod -v +x bin/unpack-sources                     &amp;&amp;
sed -e "s/target\.mk/langlist\.mk/"                \
    -e "s/tar -xf/tar -x --strip-components=1 -f/" \
    -e "/tar -x/s/lo_src_dir/start_dir/"           \
    -i bin/unpack-sources                          &amp;&amp;

./autogen.sh --prefix=$LO_PREFIX         \
             --sysconfdir=/etc           \
             --with-vendor="BLFS"        \
             --with-lang="en-US pt-BR"   \
             --with-help                 \
             --with-alloc=system         \
             --without-java              \
             --disable-gconf             \
             --disable-odk               \
             --disable-postgresql-sdbc   \
             --enable-release-build=yes  \
             --enable-python=system      \
             --with-system-boost         \
             --with-system-clucene       \
             --with-system-cairo         \
             --with-system-curl          \
             --with-system-expat         \
             --with-system-graphite      \
             --with-system-harfbuzz      \
             --with-system-icu           \
             --with-system-jpeg          \
             --with-system-lcms2         \
             --with-system-libpng        \
             --with-system-libxml        \
             --with-system-mesa-headers  \
             --with-system-neon          \
             --with-system-npapi-headers \
             --with-system-nss           \
             --with-system-odbc          \
             --with-system-openldap      \
             --with-system-openssl       \
             --with-system-poppler       \
             --with-system-redland       \
             --with-system-zlib          \
             --with-parallelism=$(getconf _NPROCESSORS_ONLN)</userinput></screen>

    <para>
      The instructions below will only build the package without running
      any unit tests. If you prefer to run the unit tests, replace
      <command>make build</command> with <command>make</command>.
    </para>

    <para>
      Build the package:
    </para>

<screen><userinput>make build</userinput></screen>

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

<screen role="root"><userinput>make distro-pack-install                                  &amp;&amp;
install -v -m755 -d $LO_PREFIX/share/appdata                &amp;&amp;
install -v -m644    sysui/desktop/appstream-appdata/*.xml \
                    $LO_PREFIX/share/appdata</userinput></screen>

    <para>
       If the dictionaries have been built, again as
       <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>chown -cR 0:0 dictionaries/                                                      &amp;&amp;
mkdir -pv $LO_PREFIX/lib/libreoffice/share/extensions/dict-en                      &amp;&amp;
cp -vR dictionaries/en/*    $LO_PREFIX/lib/libreoffice/share/extensions/dict-en    &amp;&amp;
mkdir -pv $LO_PREFIX/lib/libreoffice/share/extensions/dict-pt-BR                   &amp;&amp;
cp -vR dictionaries/pt_BR/* $LO_PREFIX/lib/libreoffice/share/extensions/dict-pt-BR</userinput></screen>

    <para>
       If installed in <filename class="directory">/opt/libreoffice-&libreoffice-dlversion;</filename>
       and the icons in the new items of the desktop menu are not properly displayed,
       optionally run the following commands, as
       <systemitem class="username">root</systemitem> user (it may be necessary
       to logout the session, before the icons appear):
    </para>

<screen role="root"><userinput>mkdir -pv /usr/share/pixmaps &amp;&amp;
for i in writer base calc draw impress math startcenter writer
do
  ln -svf /opt/libreoffice-&libreoffice-dlversion;/share/icons/hicolor/32x32/apps/libreoffice-$i.png \
          /usr/share/pixmaps/
done
unset i</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <command>sed -e ...</command>: First sed prevents compression of the
      manual pages, the second one prevents a script that causes install to
      fail from running and the third one fixes the unpack script.
    </para>

    <para>
      <command>chmod -v +x ...</command>: Fix the unpack script's permissions.
    </para>

    <para>
      <parameter>--with-vendor=BLFS</parameter>: This switch sets BLFS as
      the vendor which is mentioned when you click "About" on the toolbar.
    </para>
<!-- I believe en-US is not necessary anymore
    <para>
      <parameter>-\-with-lang="en-US pt-BR"</parameter>: This switch sets
      what languages to support. en-US is always needed. To list several
      languages, separate them with a space. For all languages, use
      <parameter>-\-with-lang=ALL</parameter>
    </para>
-->

    <para>
      <parameter>--with-lang="en-US pt-BR"</parameter>: This switch sets
      what languages to support. To list several languages, separate them with
      a space. For all languages, use
      <parameter>--with-lang=ALL</parameter>.
    </para>

    <note><para>
      For a list of the available languages, you can uncompress the
      translations tarball, <command>tar -xf
      ../libreoffice-translations-&libreoffice-dlversion;.tar.xz
      --no-overwrite-dir -C /tmp</command>, and run <command>ls
      /tmp/libreoffice-&libreoffice-dlversion;/translations/source</command>.
    </para></note>

    <para>
      <parameter>--with-help</parameter>: Without this switch, the help files
      are not built.
    </para>

    <para>
      <parameter>--with-alloc=system</parameter>: This switch tells
      <application>LibreOffice</application> to use system allocator
      instead of the internal one.
    </para>

    <para>
      <parameter>--without-java</parameter>: This switch disables
      <application>Java</application> support in
      <application>LibreOffice</application>.
    </para>

    <para>
      <parameter>--disable-gconf</parameter>: This switch disables compiling
      <application>LibreOffice</application> with the deprecated
      <application>GNOME</application> configuration system support.
    </para>

    <para>
      <parameter>--disable-odk</parameter>: This switch disables installing the
      office development kit. Remove if you want to develop a
      <application>LibreOffice</application> based application.
    </para>

    <para>
      <parameter>--disable-postgresql-sdbc</parameter>: This switch disables compiling
      <application>LibreOffice</application> with the ability to connect to a
      <application>PostgreSQL</application> database. Remove it if you would
      like <application>LibreOffice</application> to be able to connect to a
      <application>PostgreSQL</application> database. If you have installed
      <application>PostgreSQL</application> on your system and would like
      <application>LibreOffice</application> to use that rather than compile its
      own copy, use the <option>--with-system-postgresql</option> switch.
    </para>
 
    <para>
      <parameter>--enable-release-build=yes</parameter>: This switch enables a
      Release Build.
      <application>LibreOffice</application> can be built as a Release Build or
      as a Developer Build, because their default installation paths and user
      profile paths are different. Developer Build displays the words "Dev" and
      "Beta" in several places (e.g, menu and splash scren).
    </para>

    <para>
      <parameter>--enable-python=system</parameter>: This switch tells
      <application>LibreOffice</application> to use installed
      <application>Python 3</application> to build the translations
      instead of the bundled one. If you don't need to build any
      translations, you can use <option>--disable-python</option>
      instead.
    </para>

    <para>
      <parameter>--with-system-*</parameter>: These switches prevent
      <application>LibreOffice</application> from trying to compile its own
      versions of these dependencies. If you've not installed some of the
      dependencies, remove the corresponding switches.
    </para>

    <para>
      <parameter>--with-parallelism=$(getconf _NPROCESSORS_ONLN)</parameter>: This
      switch tells <application>LibreOffice</application> to use all your
      CPUs to compile in parallel and speed up the build.
    </para>

    <para>
      <option>--disable-cups</option>: Use this switch if you don't need
      printing support.
    </para>

    <para>
      <option>--disable-gstreamer-0.10</option>: Use this switch if you've
      not installed <xref linkend="gst-plugins-base"/>.
    </para>

    <para>
      <option>--disable-dbus</option>: Use this switch if you've not installed
      <xref linkend="dbus"/>. It also disables Bluetooth support and font
      install via PackageKit.
    </para>

    <para>
      <option>--enable-gstreamer</option>: Use this switch if you want to
      use <xref linkend="gst10-plugins-base"/> instead of
      <xref linkend="gst-plugins-base"/> for the avmedia module.
    </para>

    <para>
      <option>--enable-gtk3</option>: Use this switch if you want to
      build the <application>GTK+ 3</application> integration module.
    </para>

    <para>
      <option>--enable-kde4</option>: Use this switch if you want to
      build the <application>KDE</application> integration module.
    </para>

  </sect2>

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

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

      <seglistitem>
        <seg>
          libreoffice, lobase, localc, lodraw, loffice, lofromtemplate,
          loimpress, lomath, loweb, lowriter, soffice and unopkg;
          several programs under
          $LO_PREFIX/lib/libreoffice/program
        </seg>
        <seg>
          several libraries under
          $LO_PREFIX/lib/libreoffice/{ure/lib,program}
        </seg>
        <seg>
          $LO_PREFIX/lib/libreoffice
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="lobase">
        <term><command>lobase</command></term>
        <listitem>
          <para>
            is a database manager.
          </para>
          <indexterm zone="libreoffice lobase">
            <primary sortas="b-lobase">lobase</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

      <varlistentry id="lodraw">
        <term><command>lodraw</command></term>
        <listitem>
          <para>
            is a vector graphics editor and diagramming tool.
          </para>
          <indexterm zone="libreoffice lodraw">
            <primary sortas="b-lodraw">lodraw</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="loimpress">
        <term><command>loimpress</command></term>
        <listitem>
          <para>
            can edit and display PowerPoint presentations.
          </para>
          <indexterm zone="libreoffice loimpress">
            <primary sortas="b-loimpress">loimpress</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

      <varlistentry id="lowriter">
        <term><command>lowriter</command></term>
        <listitem>
          <para>
            is a word processor.
          </para>
          <indexterm zone="libreoffice lowriter">
            <primary sortas="b-lowriter">lowriter</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="unopkg">
        <term><command>unopkg</command></term>
        <listitem>
          <para>
            is a tool to manage <application>LibreOffice</application>
            extensions from the command line. 
          </para>
          <indexterm zone="libreoffice unopkg">
            <primary sortas="b-unopkg">unopkg</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>