source: xsoft/office/libreoffice.xml@ 63ba5905

<?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        "eb44cc33bb9331db4c1b6ae0b03fff9f">
  <!ENTITY libreoffice-core-size          "118 MB">

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

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

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

  <!ENTITY libreoffice-buildsize          "4.0 GB (423 MB installed) - 9.6 GB (528 MB installed), with translations">
  <!ENTITY libreoffice-time               "139 SBU - 165 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>
      <listitem>
        <para>
          Required patch for i686 systems, in order to fix a problem introduced
          by <application>&gcc-490;</application>:
          <ulink url="&patch-root;/libreoffice-&libreoffice-dlversion;-gcc_4_9_0-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <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. If you have not installed some of the dependencies listed below,
        make sure you examine the <command>./configure --help</command> output
        for information on switches needed to prevent
        <command>./configure</command> to look for them.
      </para>
    </note>

    <para role="recommended">
      <!--<xref linkend="boost"/>,-->
      <xref linkend="clucene"/>,
      <xref linkend="cups"/>,
      <xref linkend="curl"/>,
      <xref linkend="dbus-glib"/>,
      <xref linkend="glu"/>,
      <xref linkend="graphite2"/>,
      <xref linkend="gst-plugins-base"/> or
      <xref linkend="gst10-plugins-base"/>,
      <xref linkend="gtk2"/>,
      <xref linkend="harfbuzz"/>,
      <xref linkend="icu"/>,
      <xref linkend="lcms2"/>,
      <xref linkend="libjpeg"/>,
      <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>,
      <ulink url="http://www.firebirdsql.org/">Firebird</ulink>,
      <xref linkend="gdb"/>,
      <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://www.freedesktop.org/wiki/Software/libabw/">libabw</ulink>,
      <ulink url="http://www.sourceforge.net/projects/libebook/">libebook</ulink>,
      <ulink url="http://www.freedesktop.org/wiki/Software/libfreehand/">libfreehand</ulink>,
      <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 <ulink url="http://www.mysql.com/">MySQL</ulink>,
      <ulink url="http://sourceforge.net/projects/hunspell/files/MyThes/">MyThes</ulink>,
      <xref linkend="openjdk"/>,
      <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
      <xref linkend="zenity"/>
    </para>

    <para>There are many optional dependencies not listed here. They can be
    found in <quote>download.lst</quote> (source directory).
    </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 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:
    </para>

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

tar -xf ../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz --no-overwrite-dir --strip-components=1 &amp;&amp;
ln -sfv ../../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz src/ &amp;&amp;
ln -sfv ../../libreoffice-help-&libreoffice-dlversion;.tar.xz src/</userinput></screen>

    <para>
      If you have downloaded the translations tarball, create a symlink:
    </para>

<screen><userinput>ln -sfv ../../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. Change
      them to suit your needs. You might want to read the "Command Explanations"
      further below before proceeding.
    </para>

    <para>
     For i686 systems, fix a problem inroduced by
     <application>&gcc-490;</application>:
    </para>

<screen><userinput>patch -Np1 -i ../libreoffice-&libreoffice-dlversion;-gcc_4_9_0-1.patch &amp;&amp;</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=/usr               \
             --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      \
             --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 -dm755 /usr/share/appdata &amp;&amp;
install -v -m644  sysui/desktop/appstream-appdata/*.xml \
                  /usr/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 /usr/lib/libreoffice/share/extensions/dict-en                      &amp;&amp;
cp -rv    dictionaries/en/* /usr/lib/libreoffice/share/extensions/dict-en    &amp;&amp;
mkdir -pv /usr/lib/libreoffice/share/extensions/dict-pt-BR                   &amp;&amp;
cp -rv    dictionaries/pt_BR/* /usr/lib/libreoffice/share/extensions/dict-pt-BR</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>

    <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 by running the following command:
        <command>tar -xf
        ../libreoffice-translations-&libreoffice-dlversion;.tar.xz
        --no-overwrite-dir -C /tmp</command> and proceed to examine
        the contents of <filename
        class="directory">/tmp/libreoffice-&libreoffice-dlversion;/translations/source</filename>.
      </para>
    </note>

    <para>
      <parameter>--with-help</parameter>: This switch is used to build
      the help files.
    </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</parameter>: This switch is used to
      remove "Beta" or "Dev" from <application>LibreOffice</application>
      splash screen and "About" menu.
    </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-gstreamer-0-10</option>: Use this switch if you
      haven't installed <xref linkend="gst-plugins-base"/>.
    </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 Directories</segtitle>

      <seglistitem>
        <seg>
          libreoffice, lobase, localc, lodraw, loffice, lofromtemplate,
          loimpress, lomath, loweb, lowriter, soffice and unopkg
        </seg>
        <seg>
          None
        </seg>
        <seg>
          /usr/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>