[ab4fdfc] | 1 | <?xml version="1.0" encoding="UTF-8"?>
|
---|
[6732c094] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[f939f05] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
[c9b986ed] | 7 | <!ENTITY seamonkey-download-http "&mozilla-http;/seamonkey/releases/&seamonkey-version;/source/seamonkey-&seamonkey-version;.source.tar.xz">
|
---|
[6968e3cb] | 8 | <!ENTITY seamonkey-download-ftp " ">
|
---|
[4b3d207] | 9 | <!ENTITY seamonkey-md5sum "6ac064816caa2c3fe6bc1f130bd9599b">
|
---|
| 10 | <!ENTITY seamonkey-size "241 MB">
|
---|
| 11 | <!ENTITY seamonkey-buildsize "4.2 GB (159 MB installed)">
|
---|
[88dd6e72] | 12 | <!ENTITY seamonkey-time "11 SBU (with parallelism=4)">
|
---|
[a41f643] | 13 | ]>
|
---|
[f939f05] | 14 |
|
---|
[eebff7b] | 15 | <sect1 id="seamonkey" xreflabel="seamonkey-&seamonkey-version;">
|
---|
[b5eb704] | 16 | <?dbhtml filename="seamonkey.html" ?>
|
---|
[88dd2f52] | 17 |
|
---|
| 18 |
|
---|
[eebff7b] | 19 | <title>Seamonkey-&seamonkey-version;</title>
|
---|
[88dd2f52] | 20 |
|
---|
[b5eb704] | 21 | <indexterm zone="seamonkey">
|
---|
[eebff7b] | 22 | <primary sortas="a-seamonkey">seamonkey</primary>
|
---|
[88dd2f52] | 23 | </indexterm>
|
---|
| 24 |
|
---|
| 25 | <sect2 role="package">
|
---|
[eebff7b] | 26 | <title>Introduction to Seamonkey</title>
|
---|
[88dd2f52] | 27 |
|
---|
[a0d389d] | 28 | <para>
|
---|
[eebff7b] | 29 | <application>Seamonkey</application> is a browser suite, a descendant
|
---|
[99fede1f] | 30 | of <application>Netscape</application>. It includes the browser,
|
---|
| 31 | composer, mail and news clients, and an IRC client.
|
---|
[a0d389d] | 32 | </para>
|
---|
| 33 |
|
---|
| 34 | <para>
|
---|
[99fede1f] | 35 | It is the community-driven follow-on to the Mozilla Application Suite,
|
---|
| 36 | created after Mozilla decided to focus on separate applications for
|
---|
| 37 | browsing and e-mail. Those applications are
|
---|
| 38 | <xref linkend="firefox"/> and <xref linkend="thunderbird"/>.
|
---|
[a0d389d] | 39 | </para>
|
---|
[88cec02] | 40 |
|
---|
[1bf0fac] | 41 | &lfs120_checked;
|
---|
[88dd2f52] | 42 |
|
---|
| 43 | <bridgehead renderas="sect3">Package Information</bridgehead>
|
---|
| 44 | <itemizedlist spacing="compact">
|
---|
[d2e21cb0] | 45 | <listitem>
|
---|
[a0d389d] | 46 | <para>
|
---|
| 47 | Download (HTTP): <ulink url="&seamonkey-download-http;"/>
|
---|
| 48 | </para>
|
---|
[d2e21cb0] | 49 | </listitem>
|
---|
[88dd2f52] | 50 | <listitem>
|
---|
[a0d389d] | 51 | <para>
|
---|
| 52 | Download (FTP): <ulink url="&seamonkey-download-ftp;"/>
|
---|
| 53 | </para>
|
---|
[88dd2f52] | 54 | </listitem>
|
---|
| 55 | <listitem>
|
---|
[a0d389d] | 56 | <para>
|
---|
| 57 | Download MD5 sum: &seamonkey-md5sum;
|
---|
| 58 | </para>
|
---|
[88dd2f52] | 59 | </listitem>
|
---|
| 60 | <listitem>
|
---|
[a0d389d] | 61 | <para>
|
---|
| 62 | Download size: &seamonkey-size;
|
---|
| 63 | </para>
|
---|
[88dd2f52] | 64 | </listitem>
|
---|
| 65 | <listitem>
|
---|
[a0d389d] | 66 | <para>
|
---|
| 67 | Estimated disk space required: &seamonkey-buildsize;
|
---|
| 68 | </para>
|
---|
[88dd2f52] | 69 | </listitem>
|
---|
| 70 | <listitem>
|
---|
[a0d389d] | 71 | <para>
|
---|
| 72 | Estimated build time: &seamonkey-time;
|
---|
| 73 | </para>
|
---|
[88dd2f52] | 74 | </listitem>
|
---|
| 75 | </itemizedlist>
|
---|
[b74c79f] | 76 |
|
---|
[6848f3f5] | 77 | <!--
|
---|
[0fc5bfd7] | 78 | <bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
---|
[82a27795] | 79 | <itemizedlist spacing="compact">
|
---|
| 80 | <listitem>
|
---|
| 81 | <para>
|
---|
[3b3720a8] | 82 | Required patch:
|
---|
[f3250b9] | 83 | <ulink url="&patch-root;/seamonkey-&seamonkey-version;-consolidated_fixes-1.patch"/>
|
---|
[82a27795] | 84 | </para>
|
---|
| 85 | </listitem>
|
---|
[f56feddc] | 86 | <listitem>
|
---|
| 87 | <para>
|
---|
| 88 | Required Python module:
|
---|
| 89 | <ulink url="&pymodules-dl;/s/setuptools/setuptools-&setuptools-version;.tar.gz"/>
|
---|
| 90 | </para>
|
---|
| 91 | <para>
|
---|
| 92 | This module has already been installed in LFS, but now we need
|
---|
[4b3d207] | 93 | to rebuild its wheel package for the SeaMonkey build system.
|
---|
[f56feddc] | 94 | </para>
|
---|
| 95 | </listitem>
|
---|
[0fc5bfd7] | 96 | </itemizedlist>
|
---|
[6848f3f5] | 97 | -->
|
---|
[b74c79f] | 98 |
|
---|
[f06c692] | 99 | <note>
|
---|
| 100 | <para>
|
---|
| 101 | The tarball
|
---|
| 102 | <emphasis>seamonkey-&seamonkey-version;.source.tar.xz</emphasis> will
|
---|
| 103 | untar to <emphasis>seamonkey-&seamonkey-version;</emphasis> directory.
|
---|
| 104 | </para>
|
---|
| 105 | </note>
|
---|
| 106 |
|
---|
[eebff7b] | 107 | <bridgehead renderas="sect3">Seamonkey Dependencies</bridgehead>
|
---|
[88dd2f52] | 108 |
|
---|
| 109 | <bridgehead renderas="sect4">Required</bridgehead>
|
---|
[a0d389d] | 110 | <para role="required">
|
---|
[4e7ec17] | 111 | <!--xref linkend="autoconf213"/-->
|
---|
[bdfd276] | 112 | <xref linkend="cbindgen"/>,
|
---|
[b5cd03d9] | 113 | <xref linkend="gtk3"/>,
|
---|
[03adc377] | 114 | <xref linkend="nodejs"/>,
|
---|
[6848f3f5] | 115 | <xref linkend="python311"/>,
|
---|
[8558044] | 116 | <xref linkend="unzip"/>,
|
---|
| 117 | <xref linkend="yasm"/>, and
|
---|
[01cd3461] | 118 | <xref linkend="zip"/>
|
---|
[a0d389d] | 119 | </para>
|
---|
[b5eb704] | 120 |
|
---|
| 121 | <bridgehead renderas="sect4">Recommended</bridgehead>
|
---|
[a0d389d] | 122 | <para role="recommended">
|
---|
[566fcae] | 123 | <xref linkend="icu"/>,
|
---|
| 124 | <xref linkend="libevent"/>,
|
---|
[57daeab9] | 125 | <!--<xref linkend="libvpx"/>, Causes build failures similar to Firefox -->
|
---|
[f572dbb] | 126 | <xref linkend="libwebp"/>,
|
---|
| 127 | <xref linkend="llvm"/> (with clang),
|
---|
[3bf5de79] | 128 | <xref linkend="nasm"/>,
|
---|
[8558044] | 129 | <xref linkend="nspr"/>,
|
---|
[3bf5de79] | 130 | <xref linkend="nss"/>, and
|
---|
| 131 | <xref linkend="pulseaudio"/>
|
---|
| 132 | <!-- <xref linkend="sqlite"/> system version no longer supported -->
|
---|
[82a27795] | 133 | </para>
|
---|
[3a00b7b8] | 134 | <!--
|
---|
[82a27795] | 135 | <bridgehead renderas="sect4">Optional</bridgehead>
|
---|
| 136 | <para role="optional">
|
---|
| 137 | <xref linkend="sqlite"/> (not recommended due to potential
|
---|
| 138 | security concerns)
|
---|
[a0d389d] | 139 | </para>
|
---|
[3a00b7b8] | 140 | -->
|
---|
[316d9591] | 141 | <note>
|
---|
| 142 | <para>
|
---|
[566fcae] | 143 | If you don't install recommended dependencies, then internal copies of
|
---|
| 144 | those packages will be used. They might be tested to work, but they can
|
---|
| 145 | be out of date or contain security holes.
|
---|
| 146 | </para>
|
---|
| 147 | </note>
|
---|
[0a675f98] | 148 |
|
---|
[88dd2f52] | 149 | <bridgehead renderas="sect4">Optional</bridgehead>
|
---|
[a0d389d] | 150 | <para role="optional">
|
---|
[2c13ebe] | 151 | <xref linkend="alsa-lib"/>,
|
---|
[a0d389d] | 152 | <xref linkend="dbus-glib"/>,
|
---|
[566fcae] | 153 | <xref linkend="startup-notification"/>,
|
---|
| 154 | <xref linkend="valgrind"/>,
|
---|
| 155 | <xref linkend="wget"/>,
|
---|
[33befb9] | 156 | <xref linkend="wireless_tools"/>,
|
---|
[493ec31] | 157 | <ulink url="https://hunspell.sourceforge.net/">Hunspell</ulink>,
|
---|
| 158 | <ulink url="https://gitlab.gnome.org/Archive/gconf">Gconf</ulink>, and
|
---|
[33befb9] | 159 | <ulink url="https://facebook.github.io/watchman/">Watchman</ulink>
|
---|
[a0d389d] | 160 | </para>
|
---|
| 161 |
|
---|
[88dd2f52] | 162 | </sect2>
|
---|
| 163 |
|
---|
| 164 | <sect2 role="installation">
|
---|
[eebff7b] | 165 | <title>Installation of Seamonkey</title>
|
---|
[6a79dc72] | 166 |
|
---|
[a0d389d] | 167 | <para>
|
---|
[eebff7b] | 168 | The configuration of <application>Seamonkey</application> is accomplished
|
---|
[a0d389d] | 169 | by creating a <filename>mozconfig</filename> file containing the desired
|
---|
| 170 | configuration options. A default <filename>mozconfig</filename> file is
|
---|
| 171 | created below. To see the entire list of available configuration options
|
---|
| 172 | (and an abbreviated description of each one), issue
|
---|
| 173 | <command>./configure --help</command>. You may also wish to review the
|
---|
| 174 | entire file and uncomment any other desired options. Create the file by
|
---|
| 175 | issuing the following command:
|
---|
| 176 | </para>
|
---|
[7f588e9a] | 177 |
|
---|
[4def8b6] | 178 | <screen><?dbfo keep-together="auto"?><userinput>cat > mozconfig << "EOF"
|
---|
[0a675f98] | 179 | <literal># If you have a multicore machine, all cores will be used
|
---|
[d59969b] | 180 |
|
---|
[566fcae] | 181 | # If you have installed DBus-Glib comment out this line:
|
---|
[88cec02] | 182 | ac_add_options --disable-dbus
|
---|
[7f588e9a] | 183 |
|
---|
[566fcae] | 184 | # If you have installed dbus-glib, and you have installed (or will install)
|
---|
| 185 | # wireless-tools, and you wish to use geolocation web services, comment out
|
---|
| 186 | # this line
|
---|
[88cec02] | 187 | ac_add_options --disable-necko-wifi
|
---|
[d59969b] | 188 |
|
---|
[566fcae] | 189 | # Uncomment these lines if you have installed optional dependencies:
|
---|
| 190 | #ac_add_options --enable-system-hunspell
|
---|
| 191 | #ac_add_options --enable-startup-notification
|
---|
| 192 |
|
---|
[2c13ebe] | 193 | # Uncomment the following option if you have not installed PulseAudio
|
---|
| 194 | #ac_add_options --disable-pulseaudio
|
---|
| 195 | # and uncomment this if you installed alsa-lib instead of PulseAudio
|
---|
| 196 | #ac_add_options --enable-alsa
|
---|
[9bfa6854] | 197 |
|
---|
[493ec31] | 198 | # Comment out the following option if you have gconf installed
|
---|
| 199 | ac_add_options --disable-gconf
|
---|
| 200 |
|
---|
[566fcae] | 201 | # Comment out following options if you have not installed
|
---|
| 202 | # recommended dependencies:
|
---|
[3bf5de79] | 203 | ac_add_options --with-system-icu
|
---|
[566fcae] | 204 | ac_add_options --with-system-libevent
|
---|
| 205 | ac_add_options --with-system-nspr
|
---|
[257c1bf] | 206 | ac_add_options --with-system-nss
|
---|
[3bf5de79] | 207 | ac_add_options --with-system-webp
|
---|
[566fcae] | 208 |
|
---|
[88dd6e72] | 209 | # Disabling debug symbols makes the build much smaller and a little
|
---|
| 210 | # faster. Comment this if you need to run a debugger. Note: This is
|
---|
| 211 | # required for compilation on i686.
|
---|
| 212 | ac_add_options --disable-debug-symbols
|
---|
[9bfa6854] | 213 | <!-- With Firefox ESR 128 we'd replace the following part with
|
---|
| 214 | "- -enable-elf-hack=relr", or remove it if relr becomes the default.
|
---|
| 215 | But I've no idea if SeaMonkey will have this change backported. -->
|
---|
[0c3d3e5] | 216 | # The elf-hack is reported to cause failed installs (after successful builds)
|
---|
| 217 | # on some machines. It is supposed to improve startup time and it shrinks
|
---|
[29ef9b8f] | 218 | # libxul.so by a few MB. With recent Binutils releases the linker already
|
---|
| 219 | # supports a much safer and generic way for this.
|
---|
[0c3d3e5] | 220 | ac_add_options --disable-elf-hack
|
---|
[29ef9b8f] | 221 | ac_add_options --enable-linker=bfd
|
---|
| 222 | export LDFLAGS="$LDFLAGS -Wl,-z,pack-relative-relocs"
|
---|
[0c3d3e5] | 223 |
|
---|
[257c1bf] | 224 | # Seamonkey has some additional features that are not turned on by default,
|
---|
| 225 | # such as an IRC client, calendar, and DOM Inspector. The DOM Inspector
|
---|
| 226 | # aids with designing web pages. Comment these options if you do not
|
---|
| 227 | # desire these features.
|
---|
| 228 | ac_add_options --enable-calendar
|
---|
[6852cb9] | 229 | ac_add_options --enable-dominspector
|
---|
[257c1bf] | 230 | ac_add_options --enable-irc
|
---|
| 231 |
|
---|
[566fcae] | 232 | # The BLFS editors recommend not changing anything below this line:
|
---|
| 233 | ac_add_options --prefix=/usr
|
---|
[33befb9] | 234 | ac_add_options --enable-application=comm/suite
|
---|
[d59969b] | 235 |
|
---|
[a45062d] | 236 | ac_add_options --disable-crashreporter
|
---|
| 237 | ac_add_options --disable-updater
|
---|
[566fcae] | 238 | ac_add_options --disable-tests
|
---|
| 239 |
|
---|
[29ef9b8f] | 240 | # The Rust code for SIMD optimization is much more outdated than
|
---|
| 241 | # Firefox and Thunderbird, so it does not build with recent Rustc.
|
---|
[3e8c126] | 242 | ac_add_options --disable-rust-simd
|
---|
| 243 |
|
---|
[566fcae] | 244 | ac_add_options --enable-strip
|
---|
| 245 | ac_add_options --enable-install-strip
|
---|
[29ef9b8f] | 246 |
|
---|
| 247 | # You cannot distribute the binary if you do this.
|
---|
[566fcae] | 248 | ac_add_options --enable-official-branding
|
---|
| 249 |
|
---|
[0a675f98] | 250 | # The option to use system cairo was removed in 2.53.9.
|
---|
[a45062d] | 251 | ac_add_options --enable-system-ffi
|
---|
[566fcae] | 252 | ac_add_options --enable-system-pixman
|
---|
| 253 |
|
---|
| 254 | ac_add_options --with-system-bz2
|
---|
[a0ace670] | 255 | ac_add_options --with-system-jpeg
|
---|
| 256 | ac_add_options --with-system-png
|
---|
[eedb6d02] | 257 | ac_add_options --with-system-zlib
|
---|
| 258 |
|
---|
| 259 | export CC=clang CXX=clang++</literal>
|
---|
[2d237fa] | 260 | EOF</userinput></screen>
|
---|
[d59969b] | 261 |
|
---|
[5b0a978e] | 262 | <note>
|
---|
| 263 | <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
---|
| 264 | href="../../xincludes/mozshm.xml"/>
|
---|
| 265 | </note>
|
---|
[b74c79f] | 266 |
|
---|
[6848f3f5] | 267 | <!-- Restore when no longer using Python 3.11. We may want to restore the patch
|
---|
| 268 | at that point as well, which includes the 'distro' and 'ICU' changes. -renodr
|
---|
[16218efb] | 269 | <para>
|
---|
[4b3d207] | 270 | First, fix several problems that occur with Python-3.12 and ICU-74.
|
---|
| 271 | If you are not using ICU-74 and Python-3.12, do not apply this patch.
|
---|
[16218efb] | 272 | </para>
|
---|
| 273 |
|
---|
[f3250b9] | 274 | <screen><userinput>patch -Np1 -i ../seamonkey-&seamonkey-version;-consolidated_fixes-1.patch</userinput></screen>
|
---|
| 275 |
|
---|
[8a71122] | 276 | <para>
|
---|
[4b3d207] | 277 | Next, if you are using Python-3.12, reinstall the setuptools package for
|
---|
| 278 | Seamonkey, and update it's vendored copy of pip:
|
---|
[8a71122] | 279 | </para>
|
---|
| 280 |
|
---|
[4b3d207] | 281 | <screen><userinput>ln -sv /usr/lib/python&python3-majorver;/ensurepip/_bundled/pip-*.whl \
|
---|
[f56feddc] | 282 | third_party/python/virtualenv/virtualenv_support &&
|
---|
| 283 |
|
---|
| 284 | tar xf ../setuptools-&setuptools-version;.tar.gz &&
|
---|
[6848f3f5] | 285 | pip3 wheel - -no-build-isolation - -no-deps - -no-cache-dir \
|
---|
[f56feddc] | 286 | $PWD/setuptools-&setuptools-version; \
|
---|
[4b3d207] | 287 | -w third_party/python/virtualenv/virtualenv_support</userinput></screen>
|
---|
[6848f3f5] | 288 | -->
|
---|
| 289 |
|
---|
| 290 | <para>
|
---|
| 291 | First, if you are building with system ICU, adapt the line break mapping
|
---|
| 292 | for ICU-74 and later:
|
---|
| 293 | </para>
|
---|
| 294 |
|
---|
| 295 | <screen><userinput remap="pre">(for i in {43..47}; do
|
---|
| 296 | sed '/ZWJ/s/$/,CLASS_CHARACTER/' -i intl/lwbrk/LineBreaker.cpp || exit $?
|
---|
| 297 | done)</userinput></screen>
|
---|
[7be485e] | 298 |
|
---|
[2b5deee] | 299 | <para>
|
---|
[6848f3f5] | 300 | Next, fix a problem with the bundled 'distro' python module:
|
---|
[2b5deee] | 301 | </para>
|
---|
| 302 |
|
---|
[6848f3f5] | 303 | <screen><userinput remap="pre">sed -e '1012 s/stderr=devnull/stderr=subprocess.DEVNULL/' \
|
---|
[c5f66519] | 304 | -e '1013 s/OSError/(OSError, subprocess.CalledProcessError)/' \
|
---|
| 305 | -i third_party/python/distro/distro.py</userinput></screen>
|
---|
[2b5deee] | 306 |
|
---|
[a0d389d] | 307 | <para>
|
---|
[eebff7b] | 308 | Compile <application>Seamonkey</application> by running the following
|
---|
[82a27795] | 309 | commands:
|
---|
[a0d389d] | 310 | </para>
|
---|
[b0ed6bdf] | 311 |
|
---|
[f94402b] | 312 | <screen><userinput>export PATH_PY311=/opt/python3.11/bin:$PATH &&
|
---|
| 313 | PATH=$PATH_PY311 AUTOCONF=true ./mach build</userinput></screen>
|
---|
[82a27795] | 314 |
|
---|
[a0d389d] | 315 | <para>
|
---|
[72ac7f2] | 316 | This package does not come with a test suite.
|
---|
[a0d389d] | 317 | </para>
|
---|
[87c2868] | 318 |
|
---|
[a0d389d] | 319 | <para>
|
---|
[eebff7b] | 320 | Install <application>Seamonkey</application> by issuing the following
|
---|
[a0d389d] | 321 | commands as the <systemitem class="username">root</systemitem> user:
|
---|
| 322 | </para>
|
---|
[7f588e9a] | 323 |
|
---|
[d5b06a4] | 324 | <note>
|
---|
| 325 | <para>
|
---|
| 326 | If <command>sudo</command> or <command>su</command> is invoked for
|
---|
| 327 | opening a shell running as the &root; user, ensure
|
---|
| 328 | <envar>PATH_PY311</envar> is correctly passed or the
|
---|
| 329 | following command will fail. For <command>sudo</command>, use the
|
---|
| 330 | <option>--preserve-env=PATH_PY311</option> option.
|
---|
| 331 | For <command>su</command>, do <emphasis>not</emphasis> use the
|
---|
| 332 | <option>-</option> or <option>--login</option> options.
|
---|
| 333 | </para>
|
---|
| 334 | </note>
|
---|
| 335 |
|
---|
[f94402b] | 336 | <screen role="root"><userinput>PATH=$PATH_PY311 ./mach install &&
|
---|
[1eb967d9] | 337 | chown -R 0:0 /usr/lib/seamonkey &&
|
---|
[2e3b77b] | 338 |
|
---|
| 339 | cp -v $(find -name seamonkey.1 | head -n1) /usr/share/man/man1</userinput></screen>
|
---|
[3551afa] | 340 |
|
---|
[d5b06a4] | 341 | <para>
|
---|
| 342 | Finally, unset the <envar>PATH_PY311</envar> variable:
|
---|
| 343 | </para>
|
---|
| 344 |
|
---|
| 345 | <screen><userinput>unset $PATH_PY311</userinput></screen>
|
---|
| 346 |
|
---|
[7f588e9a] | 347 | </sect2>
|
---|
| 348 |
|
---|
| 349 | <sect2 role="commands">
|
---|
| 350 | <title>Command Explanations</title>
|
---|
[8a89491] | 351 |
|
---|
[ce960d7] | 352 | <para>
|
---|
[3e7f3ee] | 353 | <command>export CC=clang CXX=clang++</command>:
|
---|
[532e5c9] | 354 | With the introduction of <application>gcc-12</application>, many
|
---|
| 355 | more warnings are generated when compiling mozilla applications
|
---|
[f572dbb] | 356 | and that results in a much slower, and larger, build. Furthermore,
|
---|
| 357 | building with GCC on i?86 is currently broken.
|
---|
[532e5c9] | 358 | Although upstream mozilla code defaults to using
|
---|
| 359 | <application>llvm</application> unless overridden, the older configure
|
---|
[eebff7b] | 360 | code in <application>Seamonkey</application> defaults to gcc.
|
---|
[0a675f98] | 361 | </para>
|
---|
| 362 |
|
---|
[67f44136] | 363 | <!--
|
---|
[0a675f98] | 364 | <para>
|
---|
[4e7ec17] | 365 | <command>AUTOCONF=true ./mach configure</command>: This validates
|
---|
[8a71122] | 366 | the supplied dependencies and the <filename>mozconfig</filename>.
|
---|
[4e7ec17] | 367 | The building system always checks for an old version (2.13) of
|
---|
| 368 | autoconf, but it's not really needed because the necessary
|
---|
| 369 | <command>configure</command> scripts are already shipped in the
|
---|
| 370 | tarball and we've not modified the <filename>configure.in</filename>
|
---|
| 371 | files. So we pass <envar>AUTOCONF=true</envar> so the building system
|
---|
| 372 | will skip the checking for autoconf-2.13 and allow building this
|
---|
| 373 | package without autoconf-2.13 installed.
|
---|
[0a675f98] | 374 | </para>
|
---|
[67f44136] | 375 | -->
|
---|
[0a675f98] | 376 |
|
---|
| 377 | <para>
|
---|
| 378 | <option>./mach build --verbose</option>: Use this alternative if you
|
---|
| 379 | need details of which files are being compiled, together with any C or
|
---|
| 380 | C++ flags being used. But do not add '--verbose' to the install command,
|
---|
| 381 | it is not accepted there.
|
---|
| 382 | </para>
|
---|
| 383 |
|
---|
| 384 | <para>
|
---|
| 385 | <option>./mach build -jN</option>: The build should, by default, use
|
---|
| 386 | all the online CPU cores. If using all the cores causes the build to swap
|
---|
| 387 | because you have insufficient memory, using fewer cores can be faster.
|
---|
[a0d389d] | 388 | </para>
|
---|
| 389 |
|
---|
[88dd2f52] | 390 | </sect2>
|
---|
| 391 |
|
---|
| 392 | <sect2 role="configuration">
|
---|
[eebff7b] | 393 | <title>Configuring Seamonkey</title>
|
---|
[2e3b77b] | 394 |
|
---|
[a0d389d] | 395 | <para>
|
---|
[eebff7b] | 396 | For installing various <application>Seamonkey</application> add-ons, refer
|
---|
[8558044] | 397 | to <ulink url="https://addons.thunderbird.net/en-US/seamonkey/">Add-ons
|
---|
[33befb9] | 398 | for Seamonkey</ulink>.
|
---|
[a0d389d] | 399 | </para>
|
---|
| 400 |
|
---|
| 401 | <para>
|
---|
| 402 | Along with using the <quote>Preferences</quote> menu to configure
|
---|
[eebff7b] | 403 | <application>Seamonkey</application>'s options and preferences to suit
|
---|
[a0d389d] | 404 | individual tastes, finer grain control of many options is only available
|
---|
| 405 | using a tool not available from the general menu system. To access this
|
---|
| 406 | tool, you'll need to open a browser window and enter
|
---|
| 407 | <systemitem role="url">about:config</systemitem> in the address bar. This
|
---|
| 408 | will display a list of the configuration preferences and information
|
---|
[33befb9] | 409 | related to each one. You can use the <quote>Search:</quote> bar to enter
|
---|
[a0d389d] | 410 | search criteria and narrow down the listed items. Changing a preference
|
---|
| 411 | can be done using two methods. One, if the preference has a boolean value
|
---|
| 412 | (True/False), simply double-click on the preference to toggle the value
|
---|
| 413 | and two, for other preferences simply right-click on the desired line,
|
---|
| 414 | choose <quote>Modify</quote> from the menu and change the value. Creating
|
---|
| 415 | new preference items is accomplished in the same way, except choose
|
---|
| 416 | <quote>New</quote> from the menu and provide the desired data into the
|
---|
| 417 | fields when prompted.
|
---|
| 418 | </para>
|
---|
[7f588e9a] | 419 |
|
---|
[a0d389d] | 420 | <para>
|
---|
| 421 | If you use a desktop environment like <application>Gnome</application> or
|
---|
| 422 | <application>KDE</application> you may wish to create a
|
---|
| 423 | <filename>seamonkey.desktop</filename> file so that
|
---|
[eebff7b] | 424 | <application>Seamonkey</application> appears in the panel's menus. If you
|
---|
[a0d389d] | 425 | didn't enable <application>Startup-Notification</application> in your
|
---|
| 426 | mozconfig change the StartupNotify line to false. As the
|
---|
| 427 | <systemitem class="username">root</systemitem> user:
|
---|
| 428 | </para>
|
---|
[5e2fb70] | 429 |
|
---|
[4520f55] | 430 | <screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &&
|
---|
[fc9245e] | 431 |
|
---|
[f002c3c] | 432 | cat > /usr/share/applications/seamonkey.desktop << "EOF"
|
---|
[51dfb3e] | 433 | <literal>[Desktop Entry]
|
---|
[5e2fb70] | 434 | Encoding=UTF-8
|
---|
| 435 | Type=Application
|
---|
[eebff7b] | 436 | Name=Seamonkey
|
---|
[5e2fb70] | 437 | Comment=The Mozilla Suite
|
---|
| 438 | Icon=seamonkey
|
---|
| 439 | Exec=seamonkey
|
---|
| 440 | Categories=Network;GTK;Application;Email;Browser;WebBrowser;News;
|
---|
| 441 | StartupNotify=true
|
---|
[51dfb3e] | 442 | Terminal=false</literal>
|
---|
[5e2fb70] | 443 | EOF
|
---|
[fc9245e] | 444 |
|
---|
[5dde2656] | 445 | ln -sfv /usr/lib/seamonkey/chrome/icons/default/default128.png \
|
---|
[7226770c] | 446 | /usr/share/pixmaps/seamonkey.png</userinput></screen>
|
---|
[88dd2f52] | 447 | </sect2>
|
---|
| 448 |
|
---|
| 449 | <sect2 role="content">
|
---|
| 450 | <title>Contents</title>
|
---|
| 451 |
|
---|
| 452 | <segmentedlist>
|
---|
[7f588e9a] | 453 | <segtitle>Installed Programs</segtitle>
|
---|
[88dd2f52] | 454 | <segtitle>Installed Libraries</segtitle>
|
---|
[c5f005b] | 455 | <segtitle>Installed Directory</segtitle>
|
---|
[88dd2f52] | 456 |
|
---|
| 457 | <seglistitem>
|
---|
[88cec02] | 458 | <seg>seamonkey</seg>
|
---|
[a0d389d] | 459 | <seg>
|
---|
| 460 | Numerous libraries, browser, and email/newsgroup components, plugins,
|
---|
[4c24eb0a] | 461 | extensions, and helper modules installed in
|
---|
[4483a9a] | 462 | <filename class="directory">/usr/lib/seamonkey</filename>
|
---|
[a0d389d] | 463 | </seg>
|
---|
[7498751] | 464 | <seg>
|
---|
[33befb9] | 465 | /usr/lib/seamonkey
|
---|
[7498751] | 466 | </seg>
|
---|
[88dd2f52] | 467 | </seglistitem>
|
---|
| 468 | </segmentedlist>
|
---|
| 469 |
|
---|
| 470 | <variablelist>
|
---|
| 471 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
| 472 | <?dbfo list-presentation="list"?>
|
---|
| 473 | <?dbhtml list-presentation="table"?>
|
---|
| 474 |
|
---|
[b5eb704] | 475 | <varlistentry id="seamonkey-prog">
|
---|
| 476 | <term><command>seamonkey</command></term>
|
---|
[88dd2f52] | 477 | <listitem>
|
---|
[a0d389d] | 478 | <para>
|
---|
[4c24eb0a] | 479 | is the Mozilla browser/email/newsgroup/chat client suite
|
---|
[a0d389d] | 480 | </para>
|
---|
[b5eb704] | 481 | <indexterm zone="seamonkey seamonkey-prog">
|
---|
| 482 | <primary sortas="b-seamonkey">seamonkey</primary>
|
---|
[88dd2f52] | 483 | </indexterm>
|
---|
| 484 | </listitem>
|
---|
| 485 | </varlistentry>
|
---|
| 486 | </variablelist>
|
---|
| 487 | </sect2>
|
---|
[4c24eb0a] | 488 |
|
---|
[f45b1953] | 489 | </sect1>
|
---|