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