source: xsoft/graphweb/seamonkey.xml@ f411b49

<?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 seamonkey-download-http
  "http://ftp.mozilla.org/pub/mozilla.org/seamonkey/releases/&seamonkey-version;/source/seamonkey-&seamonkey-version;.source.tar.bz2">
  <!ENTITY seamonkey-download-ftp
  "ftp://ftp.mozilla.org/pub/mozilla.org/seamonkey/releases/&seamonkey-version;/source/seamonkey-&seamonkey-version;.source.tar.bz2">
  <!ENTITY seamonkey-md5sum        "44f9bd3c68951f2f21ab0f1fea123383">
  <!ENTITY seamonkey-size          "93.5 MB">
  <!ENTITY seamonkey-buildsize     "3 GB (46 MB installed)">
  <!ENTITY seamonkey-time          "26.6 SBU">
]>

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

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

  <title>SeaMonkey-&seamonkey-version;</title>

  <indexterm zone="seamonkey">
    <primary sortas="a-SeaMonkey">SeaMonkey</primary>
  </indexterm>

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

    <para><application>SeaMonkey</application> is a browser suite, the Open
    Source sibling of <application>Netscape</application>. It includes the
    browser, composer, mail and news clients, and an IRC client.  It is the
    follow-on to the Mozilla browser suite.</para>

    <para>The Mozilla project also hosts two subprojects that aim to satisfy
    the needs of users who don't need the complete browser suite or prefer
    to have separate applications for browsing and e-mail. These subprojects
    are <xref linkend="firefox"/> and <xref linkend="thunderbird"/>. Both are
    based on the <application>Mozilla</application> source code.
    <!-- if you delete the - -enable-application=suite option,
    <application>Thunderbird</application> will be built from this source
    tarball...--></para>

    &lfs70_checked;

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

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

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="alsa-lib"/>, <xref linkend="gtk2"/>
    <xref linkend="zip"/> and <xref linkend="unzip"/></para>

    <note>
      <para><application>libjpeg</application> and
      <application>libpng</application> (patched for apng support) should have
      been installed before <application>gdk-pixbuf</application> and should
      exist on your system. If for some strange reason you haven't
      installed them, you should remove the <option>--with-system-jpeg</option>
      and <option>--with-system-png</option> options from the
      <filename>mozconfig</filename> file created below.</para>
    </note>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended"><xref linkend="yasm"/> or
    <xref linkend="libvpx"/> (to allow <application>Seamonkey</application> to
    play webm videos).</para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="dbus-glib"/>,
    <xref linkend="startup-notification"/>, <xref linkend="sqlite"/>,
    <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
    <ulink url="http://libevent.org/">Libevent</ulink>,
    <xref linkend="doxygen"/>, <xref linkend="gnome-vfs"/> and
    <xref linkend="libgnomeui"/> (for gnome integration),
    <xref linkend="libnotify"/>, <xref linkend="nspr"/>, <xref linkend="nss"/>,
    <xref linkend="wireless_tools"/>,
    <ulink url="http://www.valgrind.org/">Valgrind</ulink> (only for testing
    the jemalloc code) and <xref linkend="wget"/></para>

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

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

    <para>The configuration of <application>SeaMonkey</application> is
    accomplished by creating a <filename>mozconfig</filename> file containing
    the desired configuration options. A default <filename>mozconfig</filename>
    file is created below. To see the entire list of available configuration
    options (and an abbreviated description of each one), issue
    <command>./configure --help</command>. You may also wish to review the
    entire file and uncomment any other desired options. Create the file by
    issuing the following command:</para>

<screen><?dbfo keep-together="auto"?><userinput>cat &gt; .mozconfig &lt;&lt; "EOF"
# If you have a multicore machine you can speed up the build by running
# several jobs at once, but if you have a single core, delete this line:
mk_add_options MOZ_MAKE_FLAGS="-j4"

# If you have installed Yasm delete this option:
ac_add_options --disable-webm

# If you have installed DBus-Glib delete this option:
ac_add_options --disable-dbus

# If you have installed wireless-tools delete this option:
ac_add_options --disable-necko-wifi

# If you have installed libnotify delete this option:
ac_add_options --disable-libnotify

# Uncomment these if you have installed them:
# ac_add_options --with-system-nspr
# ac_add_options --with-system-nss
# ac_add_options --enable-system-sqlite
# ac_add_options --with-system-libvpx
# ac_add_options --enable-startup-notification
# ac_add_options --enable-system-hunspell
# ac_add_options --with-system-libevent

mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/moz-build-dir
ac_add_options --enable-application=suite
ac_add_options --prefix=/usr
ac_add_options --with-pthreads
ac_add_options --enable-system-ffi
ac_add_options --with-system-jpeg
ac_add_options --with-system-png
ac_add_options --enable-system-cairo
ac_add_options --with-system-zlib
ac_add_options --enable-shared
ac_add_options --disable-static
ac_add_options --disable-debug
ac_add_options --disable-crashreporter
ac_add_options --disable-installer
ac_add_options --disable-updater
ac_add_options --disable-tests
EOF</userinput></screen>

    <para>Compile <application>SeaMonkey</application> by running the
    following command:</para>

<screen><userinput>sed -i 's#VPX_CODEC_USE_INPUT_PARTITION#VPX_CODEC_USE_INPUT_FRAGMENTS#' \
  mozilla/configure &amp;&amp;
make -f client.mk</userinput></screen>

    <para>This package does not come with a test suite. However, it
    can be launched from the build directory before installing with the
    command line:
    <userinput>moz-build-dir/mozilla/dist/seamonkey/seamonkey</userinput></para>

    <para>Install <application>SeaMonkey</application> by issuing the following
    commands as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make -C moz-build-dir install &amp;&amp;
mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
ln -svf ../mozilla/plugins /usr/lib/seamonkey-&seamonkey-version; &amp;&amp;
cp -v moz-build-dir/mozilla/dist/man/man1/seamonkey.1 /usr/share/man/man1</userinput></screen>
  </sect2>

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

    <para><command>sed -i 's#VPX_CODEC_USE ...</command>: This fixes
    mozilla's <command>configure</command> script to properly detect
    libvpx-v1.0.0. This sed is not needed if you have libvpx-v0.9.7 or earlier
    installed or if you've not installed <xref linkend="libvpx"/>.</para>

    <para><command>make -f client.mk</command>: Mozilla products are
    packaged to allow the use of a configuration file which can be used to
    pass the configuration settings to the <command>configure</command>
    command. <command>make</command> uses the <filename>client.mk</filename>
    file to get initial configuration and setup parameters.</para>

    <para><command>make -C moz-build-dir install</command>: this runs
    <command>make install</command> inside the moz-build-dir
    directory.</para>

    <para><command>ln -s ../mozilla/plugins
    /usr/lib/seamonkey-&seamonkey-version;</command>: this creates a symlink to
    <filename class="directory">/usr/lib/mozilla/plugins</filename> for the
    sake of compatibility, to keep all your plugins in the place mozilla
    plugins are normally found.</para>
  </sect2>

  <sect2 role="configuration">
    <title>Configuring SeaMonkey</title>

    <para>If you deleted the <option>--disable-webm</option> option from your
    <filename>mozconfig</filename>, your <application>Seamonkey</application>
    can play most youtube videos without the need for the flash plugin. To
    enable this, go to <ulink
    url="http://www.youtube.com/html5">http://www.youtube.com/html5</ulink>
    and click on 'Join the HTML5 Trial' (needs cookies enabled).</para>

    <para>For installing various <application>SeaMonkey</application> plugins,
    refer to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's
    PluginDoc Project</ulink>.</para>

    <para>Along with using the <quote>Preferences</quote> menu to configure
    <application>SeaMonkey</application>'s options and preferences to suit
    individual tastes, finer grain control of many options is only available
    using a tool not available from the general menu system. To access this
    tool, you'll need to open a browser window and enter
    <systemitem role="url">about:config</systemitem> in the
    address bar. This will display a list of the configuration preferences and
    information related to each one. You can use the <quote>Filter:</quote> bar
    to enter search criteria and narrow down the listed items. Changing a
    preference can be done using two methods. One, if the preference has a
    boolean value (True/False), simply double-click on the preference to toggle
    the value and two, for other preferences simply right-click on the desired
    line, choose <quote>Modify</quote> from the menu and change the value.
    Creating new preference items is accomplished in the same way, except
    choose <quote>New</quote> from the menu and provide the desired data into
    the fields when prompted.</para>

    <tip>
      <para>There is a multitude of configuration parameters you can tweak to
      customize <application>SeaMonkey</application>. A very extensive list
      of these parameters can be found at <ulink
      url="http://preferential.mozdev.org/preferences.html"/>.</para>
    </tip>

    <para>If you use a desktop environment like <application>Gnome</application>
    or <application>KDE</application> you may wish to create a
    seamonkey.desktop file so that <application>Seamonkey</application>
    appears in the panel's menus. If you didn't enable
    startup-notification in your mozconfig change the StartupNotify line to
    false. As the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>cat &gt; /usr/share/applications/seamonkey.desktop &lt;&lt; "EOF"
[Desktop Entry]
Encoding=UTF-8
Type=Application
Name=Seamonkey
Comment=The Mozilla Suite
Icon=seamonkey
Exec=seamonkey
Categories=Network;GTK;Application;Email;Browser;WebBrowser;News;
StartupNotify=true
Terminal=false
EOF
ln -sv -f /usr/lib/seamonkey-&seamonkey-version;/chrome/icons/default/seamonkey.png /usr/share/pixmaps</userinput></screen>
  </sect2>

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

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

      <seglistitem>
        <seg>seamonkey</seg>
        <seg>Numerous libraries, browser, and email/newsgroup components,
        plugins, extensions, and helper modules installed in <filename
        class="directory">/usr/lib/seamonkey-&seamonkey-version;</filename></seg>
        <seg>/usr/lib/seamonkey-&seamonkey-version;</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="seamonkey-prog">
        <term><command>seamonkey</command></term>
        <listitem>
          <para>is a browser/email/newsgroup/chat client suite. The
          various components such as the Composer, mail-news client,
          IRC chat client, and address book can be accessed from the menu after
          <command>seamonkey</command> starts or via command-line switches to
          the <command>seamonkey</command> script. Issue
          <command>man seamonkey</command> for additional information.</para>
          <indexterm zone="seamonkey seamonkey-prog">
            <primary sortas="b-seamonkey">seamonkey</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>
  </sect2>
</sect1>