glfs/xsoft/office/libreoffice.xml

<?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        "2c92879fa8c50d0071c4703afb7d10bf">
  <!ENTITY libreoffice-core-size          "100 MB">

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

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

  <!ENTITY libreoffice-translations-download-http "&libreoffice-dl;/libreoffice-translations-&libreoffice-dlversion;.tar.xz">
  <!ENTITY libreoffice-translations-md5sum        "8b61fbfa6bcd18213b5744f2b8a289b0">
  <!ENTITY libreoffice-translations-size          "123 MB">

  <!ENTITY libreoffice-buildsize          "7.1 GB (450 MB installed)">
  <!ENTITY libreoffice-time               "80 SBU">
]>

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

    &lfs72_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="gtk2"/>,
      <application>Perl Modules</application>
      <xref linkend="perl-archive-zip"/> and
      <xref linkend="perl-xml-parser"/>,
      <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="cups"/>,
      <xref linkend="curl"/>,
      <xref linkend="dbus"/>,
      <xref linkend="expat"/>,
      <xref linkend="gst-plugins-base"/> or
      <xref linkend="gst10-plugins-base"/>,
      <xref linkend="icu"/>,
      <xref linkend="lcms2"/>,
      <xref linkend="librsvg"/>,
      <xref linkend="libxml2"/> and
      <xref linkend="libxslt"/>,
      <xref linkend="mesalib"/>,
      <xref linkend="neon"/>,
      <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="bluez"/>,
      <ulink url="http://sourceforge.net/projects/cppunit/">Cppunit</ulink>,
      <ulink url="http://sourceforge.net/projects/silgraphite/">Graphite2</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"/>,
      <ulink url="http://sourceforge.net/projects/libwpd/">libwpd</ulink>,
      <ulink url="http://sourceforge.net/projects/libwpg/">libwpg</ulink>,
      <ulink url="http://sourceforge.net/projects/libwps/">libwps</ulink>,
      <xref linkend="mysql"/>,
      <ulink url="http://sourceforge.net/projects/hunspell/files/MyThes/">MyThes</ulink>,
      <xref linkend="postgresql"/>,
      <xref linkend="sane"/> and
      <xref linkend="zenity"/>
    </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 and help files 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 -xvf ../libreoffice-dictionaries-&libreoffice-dlversion;.tar.xz --no-overwrite-dir --strip-components=1 &amp;&amp;
tar -xvf ../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>

    <para>
      If you have downloaded the translations tarball, unpack it:
    </para>

<screen><userinput>tar -xvf ../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>

    <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>
      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.top &amp;&amp;
./autogen.sh --prefix=/usr              \
             --sysconfdir=/etc          \
             --with-vendor="BLFS"       \
             --with-lang=""             \
             --with-alloc=system        \
             --without-java             \
             --disable-gconf            \
             --disable-odk              \
             --disable-postgresql-sdbc  \
             --enable-python=system     \
             --with-system-cairo        \
             --with-system-curl         \
             --with-system-expat        \
             --with-system-icu          \
             --with-system-jpeg         \
             --with-system-lcms2        \
             --with-system-libpng       \
             --with-system-libxml       \
             --with-system-mesa-headers \
             --with-system-neon         \
             --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</userinput></screen>

  </sect2>

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

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

    <para>
      <parameter>--with-vendor=BLFS</parameter>: This switchs 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. 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>
      For a list of the available languages, run:
      <command>ls translations/source</command> after you have extracted
      the translations tarball.
    </para>

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

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

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

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

    <para>
      <option>--disable-postgresql-sdbc</option>: 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-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>
      <option>--with-system-*</option>: 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>
      <option>--with-parallelism=$(getconf _NPROCESSORS_ONLN)</option>: 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>--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
        </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>