source: xsoft/suites/openoffice.xml@ bcd89599

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY openoffice-download-http "http://download.openoffice.org/&openoffice-version;/source.html">
  <!ENTITY openoffice-download-ftp  " ">
  <!ENTITY openoffice-size          "189 MB">
  <!ENTITY openoffice-buildsize     "5.0 GB">
  <!ENTITY openoffice-time          " ">
]>

<sect1 id="openoffice" xreflabel="OpenOffice-&openoffice-version;">
<?dbhtml filename="openoffice.html" ?>
<title>OpenOffice-&openoffice-version;</title>

<sect2>
<title>Introduction to <application>OpenOffice</application></title>

<para>The <application>OpenOffice</application> is an office suite, the 
Open Source sibling of <application>StarOffice</application>.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&openoffice-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&openoffice-download-ftp;"/></para></listitem>
<listitem><para>Download size: &openoffice-size;</para></listitem>
<listitem><para>Estimated Disk space required:
&openoffice-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&openoffice-time;</para></listitem>
</itemizedlist>
</sect3>

<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>General Polygon Clipper Library (Optional if <xref linkend="libart_lgpl"/> is used): <ulink
url="ftp://ftp.cs.man.ac.uk/pub/toby/gpc/gpc231.tar.Z"/></para></listitem>
<listitem><para>Required patch (Executable <command>test</command> is in
<filename class="directory">/bin</filename>,
not in <filename class="directory">/usr/bin</filename>): <ulink
url="&patch-root;/openoffice-&openoffice-version;-test_bin_loc-1.patch"/></para></listitem>
<listitem><para>Required patch if <xref linkend="Linux_PAM"/> is not installed: <ulink
url="&patch-root;/openoffice-&openoffice-version;-no_pam-1.patch"/></para></listitem>
<listitem><para>Required patch if compiling with <acronym>JDK</acronym> 1.4.2: <ulink
url="&patch-root;/openoffice-&openoffice-version;-jdk_1.4.2_fix-1.patch"/></para></listitem>
<listitem><para>Recommended patch: <ulink
url="&patch-root;/openoffice-&openoffice-version;-domainname-1.patch"/></para></listitem>
<listitem><para>The source <acronym>TAR</acronym> ball only contains English language help. A localized help
content file may be available at <ulink
url="http://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/helpcontent/"/>.</para></listitem></itemizedlist>
</sect3>

<sect3><title><application>OpenOffice</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="zip"/>, <xref linkend="unzip"/>, <xref linkend="tcsh"/>,
<xref linkend="which"/></para></sect4>
<sect4><title>Recommended</title>
<para><xref linkend="j2sdk"/></para></sect4>
<sect4><title>Optional</title>
<para><xref linkend="Linux_PAM"/>,
<xref linkend="libart_lgpl"/>,
<xref linkend="startup-notification"/> and <ulink
url="http://ant.apache.org/">Apache Ant</ulink></para></sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>OpenOffice</application></title>

<para>Apply the downloaded patches and optionally copy the gpc files.</para>

<screen><userinput><command>mv ../gpc231/* external/gpc &amp;&amp;
for p in ../openoffice-&openoffice-version;-*.patch
do patch -Np1 -i $p
done</command></userinput></screen>

<para>If you want to optimize the build, edit
<filename>solenv/inc/unxlngi4.mk</filename> and add the desired optimization
flags to the <envar>CFLAGSOPT</envar> variable. Some users have reported 
problems with -fomit-frame-pointer. The best option is to not use any custom 
optimizations. The following command removes an incorrect -mcpu option in the 
above file.</para>

<screen><userinput><command>sed -i "s:\-mcpu=pentiumpro::" \
solenv/inc/unxlngi4.mk</command></userinput></screen>

<para>Configure <application>OpenOffice</application> using the following 
commands. You may build install sets for only specific languages based on your 
preferences. If a particular component is not available in the language of your 
choice, the default will be English. The following option compiles all 
available languages. If you restrict the languages, be sure to add ENUS to the 
list; otherwise the build fails. Also, the build fails when the environment 
variable <envar>LANG</envar> is set. Unset it before compiling.</para>

<screen><userinput><command>cd config_office/ &amp;&amp;
./configure --with-lang=ALL \
    --with-dict=ALL --without-fonts \
    --enable-libsn --with-system-zlib &amp;&amp;
cd ..</command></userinput></screen>

<para>Compile <application>OpenOffice</application> using the following
commands.</para>

<note><para><application>OpenOffice</application> fails to compile if the 
umask is set to something exotic. Set umask to 022 if you normally set it to 
something else.</para></note>

<screen><userinput><command>./bootstrap &amp;&amp;
bash -c "source LinuxIntelEnv.Set.sh; dmake"</command></userinput></screen>

<para>If you have downloaded localized help content zip files, you will need
to unzip them to the appropriate directory as mentioned below and then recreate
the installation set.</para>

<screen><userinput><command>cd solver/645/unxlngi4.pro/pck &amp;&amp;
for i in $(ls ../../../../../helpcontent_*_unix.tgz)
do
tar -xvzf $i
done &amp;&amp;
cd ../../../../instsetoo &amp;&amp;
rm -rf unxlngi4.pro &amp;&amp;
cd .. &amp;&amp;
bash -c "source LinuxIntelEnv.Set.sh ; dmake"</command></userinput></screen>

<para>Install <application>OpenOffice</application> using the following
commands to install the English language set. To install a localized version,
replace the 01 with the international telephone country code for your country.
Note that when installing, <application>OpenOffice</application> needs an
<application>X</application> display, even though there is no visible
<application>X</application> window. You can use
<application>Xvfb</application> if you are compiling on a console.</para>

<screen><userinput><command>cd instsetoo/unxlngi4.pro/01/normal &amp;&amp;
sed -i "s:^oo_home=.*:oo_home=openoffice:" install &amp;&amp;
./install --prefix=/opt &amp;&amp;
for appl in swriter scalc sdraw simpress smath soffice spadmin
do ln -sf /opt/openoffice/program/$appl /usr/bin/$appl
done</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para>
<command>mv ../gpc231/gpc.* external/gpc</command>: Copy the gpc files to the 
appropriate location.</para>

<para><parameter>--with-lang=ALL</parameter>: Make install sets for all 
available languages.</para>

<para><parameter>--with-dict=ALL</parameter>: Install dictionaries for all 
available languages.</para>

<para><parameter>--with-libart</parameter>: Use libart instead of gpc for 
polygon clipping.</para>

<para><parameter>--with-libsn</parameter>: Use startup-notification.</para>

<para><parameter>--disable-java</parameter>: Do not build components that need 
java.</para>

<para><parameter>--without-gpc</parameter>: Do not use gpc. Removes polygon 
clipping capability.</para>

<para><parameter>--without-fonts</parameter>: Do not install Bitstream Vera 
fonts since they are already bundled with X.</para>

<para><command>./bootstrap</command>: Create packages required to bootstrap 
the build.</para>

<para><command>dmake</command>: Compile the package.</para>

<para><command>sed -i "s:^oo_home=...</command>: Remove version specific
installation directory.</para>

<para><command>for appl in swriter scalc sdraw simpress smath soffice;
do ...</command>: Create links so that the package can be started from the 
command-line without changes to the existing path.</para>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>OpenOffice</application> package contains
<command>swriter</command>,
<command>simpress</command>, <command>scalc</command>,
<command>sdraw</command>, <command>smath</command>,
and <command>spadmin</command>.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>swriter</title>
<para>Word processing application.</para></sect3>

<sect3><title>simpress</title>
<para>Presentation application.</para></sect3>

<sect3><title>scalc</title>
<para>Spreadsheet application.</para></sect3>

<sect3><title>sdraw</title>
<para>Drawing application.</para></sect3>

<sect3><title>smath</title>
<para>Mathematical formula editor.</para></sect3>

<sect3><title>spadmin</title>
<para>OpenOffice Printer Configuration. You may need to run this if
you are having any printing problems.</para></sect3>

</sect2>

</sect1>