source: xsoft/graphweb/seamonkey.xml@ 22819855

12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 22819855 was eebff7b, checked in by Bruce Dubbs <bdubbs@…>, 8 months ago

Typos

  • Property mode set to 100644
File size: 16.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY seamonkey-download-http "&mozilla-http;/seamonkey/releases/&seamonkey-version;/source/seamonkey-&seamonkey-version;.source.tar.xz">
8 <!ENTITY seamonkey-download-ftp " ">
9 <!ENTITY seamonkey-md5sum "15c73a5e725b7f002b2789706ae643d9">
10 <!ENTITY seamonkey-size "254 MB">
11 <!ENTITY seamonkey-buildsize "4.3 GB (159 MB installed)">
12 <!ENTITY seamonkey-time "11 SBU (with parallelism=4)">
13]>
14
15<sect1 id="seamonkey" xreflabel="seamonkey-&seamonkey-version;">
16 <?dbhtml filename="seamonkey.html" ?>
17
18
19 <title>Seamonkey-&seamonkey-version;</title>
20
21 <indexterm zone="seamonkey">
22 <primary sortas="a-seamonkey">seamonkey</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Seamonkey</title>
27
28 <para>
29 <application>Seamonkey</application> is a browser suite, a descendant
30 of <application>Netscape</application>. It includes the browser,
31 composer, mail and news clients, and an IRC client.
32 </para>
33
34 <para>
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"/>.
39 </para>
40
41 &lfs120_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&seamonkey-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&seamonkey-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &seamonkey-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &seamonkey-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &seamonkey-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &seamonkey-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
78 <itemizedlist spacing="compact">
79 <listitem>
80 <para>
81 Required patch:
82 <ulink url="&patch-root;/seamonkey-&seamonkey-version;-consolidated_fixes-1.patch"/>
83 </para>
84 </listitem>
85 </itemizedlist>
86
87 <note>
88 <para>
89 The tarball
90 <emphasis>seamonkey-&seamonkey-version;.source.tar.xz</emphasis> will
91 untar to <emphasis>seamonkey-&seamonkey-version;</emphasis> directory.
92 </para>
93 </note>
94
95 <bridgehead renderas="sect3">Seamonkey Dependencies</bridgehead>
96
97 <bridgehead renderas="sect4">Required</bridgehead>
98 <para role="required">
99 <xref linkend="autoconf213"/>,
100 <xref linkend="cbindgen"/>,
101 <xref linkend="gtk3"/>,
102 <xref linkend="nodejs"/>,
103 <xref linkend="unzip"/>,
104 <xref linkend="yasm"/>, and
105 <xref linkend="zip"/>
106 </para>
107
108 <bridgehead renderas="sect4">Recommended</bridgehead>
109 <para role="recommended">
110 <xref linkend="icu"/>,
111 <xref linkend="libevent"/>,
112 <!--<xref linkend="libvpx"/>, Causes build failures similar to Firefox -->
113 <xref linkend="libwebp"/>,
114 <xref linkend="llvm"/> (with clang),
115 <xref linkend="nasm"/>,
116 <xref linkend="nspr"/>,
117 <xref linkend="nss"/>, and
118 <xref linkend="pulseaudio"/>
119 <!-- <xref linkend="sqlite"/> system version no longer supported -->
120 </para>
121<!--
122 <bridgehead renderas="sect4">Optional</bridgehead>
123 <para role="optional">
124 <xref linkend="sqlite"/> (not recommended due to potential
125 security concerns)
126 </para>
127-->
128 <note>
129 <para>
130 If you don't install recommended dependencies, then internal copies of
131 those packages will be used. They might be tested to work, but they can
132 be out of date or contain security holes.
133 </para>
134 </note>
135
136 <bridgehead renderas="sect4">Optional</bridgehead>
137 <para role="optional">
138 <xref linkend="alsa-lib"/>,
139 <!--<xref linkend="curl"/>,-->
140 <xref linkend="dbus-glib"/>,
141 <!--<xref linkend="doxygen"/>,-->
142 <xref linkend="GConf"/>,
143 <!--<xref linkend="gst10-plugins-base"/> (and other plugins, only for tests),-->
144 <!--<xref linkend="openjdk"/>, Not seen in logs -->
145 <xref linkend="startup-notification"/>,
146 <xref linkend="valgrind"/>,
147 <xref linkend="wget"/>,
148 <xref linkend="wireless_tools"/>,
149 <ulink url="https://hunspell.sourceforge.net/">Hunspell</ulink>, and
150 <ulink url="https://facebook.github.io/watchman/">Watchman</ulink>
151 </para>
152
153 <para condition="html" role="usernotes">
154 Editor Notes: <ulink url="&blfs-wiki;/seamonkey"/>
155 </para>
156
157 </sect2>
158
159 <sect2 role="installation">
160 <title>Installation of Seamonkey</title>
161
162 <para>
163 The configuration of <application>Seamonkey</application> is accomplished
164 by creating a <filename>mozconfig</filename> file containing the desired
165 configuration options. A default <filename>mozconfig</filename> file is
166 created below. To see the entire list of available configuration options
167 (and an abbreviated description of each one), issue
168 <command>./configure --help</command>. You may also wish to review the
169 entire file and uncomment any other desired options. Create the file by
170 issuing the following command:
171 </para>
172
173<screen><?dbfo keep-together="auto"?><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
174<literal># If you have a multicore machine, all cores will be used
175
176# If you have installed DBus-Glib comment out this line:
177ac_add_options --disable-dbus
178
179# If you have installed dbus-glib, and you have installed (or will install)
180# wireless-tools, and you wish to use geolocation web services, comment out
181# this line
182ac_add_options --disable-necko-wifi
183
184# Uncomment these lines if you have installed optional dependencies:
185#ac_add_options --enable-system-hunspell
186#ac_add_options --enable-startup-notification
187
188# Uncomment the following option if you have not installed PulseAudio
189#ac_add_options --disable-pulseaudio
190# and uncomment this if you installed alsa-lib instead of PulseAudio
191#ac_add_options --enable-alsa
192
193# Comment out following option if you have gconf installed
194ac_add_options --disable-gconf
195<!-- comments cause a blank line, following was for icu in the past
196 seems OK with icu-60, seamonkey-2.49
197 line below was with comment and explanation
198# Use the internal version of icu due to execution problems-->
199# Comment out following options if you have not installed
200# recommended dependencies:
201ac_add_options --with-system-icu
202ac_add_options --with-system-libevent
203ac_add_options --with-system-nspr
204ac_add_options --with-system-nss
205ac_add_options --with-system-webp
206
207# Disabling debug symbols makes the build much smaller and a little
208# faster. Comment this if you need to run a debugger. Note: This is
209# required for compilation on i686.
210ac_add_options --disable-debug-symbols
211
212# The elf-hack is reported to cause failed installs (after successful builds)
213# on some machines. It is supposed to improve startup time and it shrinks
214# libxul.so by a few MB - comment this if you know your machine is not affected.
215ac_add_options --disable-elf-hack
216
217# Seamonkey has some additional features that are not turned on by default,
218# such as an IRC client, calendar, and DOM Inspector. The DOM Inspector
219# aids with designing web pages. Comment these options if you do not
220# desire these features.
221ac_add_options --enable-calendar
222ac_add_options --enable-dominspector
223ac_add_options --enable-irc
224
225# The BLFS editors recommend not changing anything below this line:
226ac_add_options --prefix=/usr
227ac_add_options --enable-application=comm/suite
228
229ac_add_options --disable-crashreporter
230ac_add_options --disable-updater
231ac_add_options --disable-tests
232
233# rust-simd does not compile with recent versions of rust.
234# It is disabled in recent versions of firefox
235ac_add_options --disable-rust-simd
236
237ac_add_options --enable-optimize="-O2"
238ac_add_options --enable-strip
239ac_add_options --enable-install-strip
240ac_add_options --enable-official-branding
241
242# The option to use system cairo was removed in 2.53.9.
243ac_add_options --enable-system-ffi
244ac_add_options --enable-system-pixman
245
246ac_add_options --with-system-bz2
247ac_add_options --with-system-jpeg
248ac_add_options --with-system-png
249ac_add_options --with-system-zlib</literal>
250EOF</userinput></screen>
251
252 <note>
253 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
254 href="../../xincludes/mozshm.xml"/>
255 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
256 href="../../xincludes/mozmach.xml"/>
257 </note>
258
259 <para>
260 First, apply a security patch that fixes some problems with
261 Seamonkey's bundled version of libvpx:
262 </para>
263
264<screen><userinput>patch -Np1 -i ../seamonkey-&seamonkey-version;-consolidated_fixes-1.patch</userinput></screen>
265
266<!--
267 <para>
268 Next, work around a problem in the Python virtual environment:
269 </para>
270
271<screen><userinput>sed -i "/if sys.executable !=/i\ open(join(bin_dir, 'pyvenv.cfg'), 'w').close()" \
272 third_party/python/virtualenv/virtualenv.py</userinput></screen>
273-->
274
275 <para>
276 Fix a problem with the bundled 'distro' python module:
277 </para>
278
279<screen><userinput>sed -e '1012 s/stderr=devnull/stderr=subprocess.DEVNULL/' \
280 -e '1013 s/OSError/(OSError, subprocess.CalledProcessError)/' \
281 -i third_party/python/distro/distro.py</userinput></screen>
282
283 <para>
284 Compile <application>Seamonkey</application> by running the following
285 commands:
286 </para>
287
288<screen><userinput>export CC=clang CXX=clang++ &amp;&amp;
289./mach configure &amp;&amp;
290./mach build</userinput></screen>
291
292
293 <!-- comment this since llvm must have been installed for rust
294 <note>
295 <para>
296 The CC and CXX variables above are only needed if
297 <xref linkend="llvm"/> is installed and you do not want to use clang.
298 </para>
299 </note>-->
300
301 <para>
302 This package does not come with a test suite.
303 </para>
304
305 <para>
306 Install <application>Seamonkey</application> by issuing the following
307 commands as the <systemitem class="username">root</systemitem> user:
308 </para>
309
310
311<screen role="root"><userinput>./mach install &amp;&amp;
312chown -R 0:0 /usr/lib/seamonkey &amp;&amp;
313
314cp -v $(find -name seamonkey.1 | head -n1) /usr/share/man/man1</userinput></screen>
315
316 </sect2>
317
318 <sect2 role="commands">
319 <title>Command Explanations</title>
320
321 <para>
322 <command>export CC=clang CXX=clang++</command>:
323 With the introduction of <application>gcc-12</application>, many
324 more warnings are generated when compiling mozilla applications
325 and that results in a much slower, and larger, build. Furthermore,
326 building with GCC on i?86 is currently broken.
327 Although upstream mozilla code defaults to using
328 <application>llvm</application> unless overridden, the older configure
329 code in <application>Seamonkey</application> defaults to gcc.
330 </para>
331
332 <para>
333 <command>./mach configure</command>: This validates
334 the supplied dependencies and the <filename>mozconfig</filename>.
335 <!--This is run twice because problems with mach will cause it to fail the
336 first time.-->
337 </para>
338
339 <para>
340 <option>./mach build --verbose</option>: Use this alternative if you
341 need details of which files are being compiled, together with any C or
342 C++ flags being used. But do not add '--verbose' to the install command,
343 it is not accepted there.
344 </para>
345
346 <para>
347 <option>./mach build -jN</option>: The build should, by default, use
348 all the online CPU cores. If using all the cores causes the build to swap
349 because you have insufficient memory, using fewer cores can be faster.
350 </para>
351
352 </sect2>
353
354 <sect2 role="configuration">
355 <title>Configuring Seamonkey</title>
356
357 <para>
358 For installing various <application>Seamonkey</application> add-ons, refer
359 to <ulink url="https://addons.thunderbird.net/en-US/seamonkey/">Add-ons
360 for Seamonkey</ulink>.
361 </para>
362
363 <para>
364 Along with using the <quote>Preferences</quote> menu to configure
365 <application>Seamonkey</application>'s options and preferences to suit
366 individual tastes, finer grain control of many options is only available
367 using a tool not available from the general menu system. To access this
368 tool, you'll need to open a browser window and enter
369 <systemitem role="url">about:config</systemitem> in the address bar. This
370 will display a list of the configuration preferences and information
371 related to each one. You can use the <quote>Search:</quote> bar to enter
372 search criteria and narrow down the listed items. Changing a preference
373 can be done using two methods. One, if the preference has a boolean value
374 (True/False), simply double-click on the preference to toggle the value
375 and two, for other preferences simply right-click on the desired line,
376 choose <quote>Modify</quote> from the menu and change the value. Creating
377 new preference items is accomplished in the same way, except choose
378 <quote>New</quote> from the menu and provide the desired data into the
379 fields when prompted.
380 </para>
381
382<!-- The URL no longer exists.
383 <tip>
384 <para>
385 There is a multitude of configuration parameters you can tweak to
386 customize <application>SeaMonkey</application>. A very extensive list of
387 these parameters can be found at
388 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
389 </para>
390 </tip>
391-->
392 <para>
393 If you use a desktop environment like <application>Gnome</application> or
394 <application>KDE</application> you may wish to create a
395 <filename>seamonkey.desktop</filename> file so that
396 <application>Seamonkey</application> appears in the panel's menus. If you
397 didn't enable <application>Startup-Notification</application> in your
398 mozconfig change the StartupNotify line to false. As the
399 <systemitem class="username">root</systemitem> user:
400 </para>
401
402<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
403
404cat &gt; /usr/share/applications/seamonkey.desktop &lt;&lt; "EOF"
405<literal>[Desktop Entry]
406Encoding=UTF-8
407Type=Application
408Name=Seamonkey
409Comment=The Mozilla Suite
410Icon=seamonkey
411Exec=seamonkey
412Categories=Network;GTK;Application;Email;Browser;WebBrowser;News;
413StartupNotify=true
414Terminal=false</literal>
415EOF
416
417ln -sfv /usr/lib/seamonkey/chrome/icons/default/default128.png \
418 /usr/share/pixmaps/seamonkey.png</userinput></screen>
419 </sect2>
420
421 <sect2 role="content">
422 <title>Contents</title>
423
424 <segmentedlist>
425 <segtitle>Installed Programs</segtitle>
426 <segtitle>Installed Libraries</segtitle>
427 <segtitle>Installed Directory</segtitle>
428
429 <seglistitem>
430 <seg>seamonkey</seg>
431 <seg>
432 Numerous libraries, browser, and email/newsgroup components, plugins,
433 extensions, and helper modules installed in
434 <filename class="directory">/usr/lib/seamonkey</filename>
435 </seg>
436 <seg>
437 /usr/lib/seamonkey
438 </seg>
439 </seglistitem>
440 </segmentedlist>
441
442 <variablelist>
443 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
444 <?dbfo list-presentation="list"?>
445 <?dbhtml list-presentation="table"?>
446
447 <varlistentry id="seamonkey-prog">
448 <term><command>seamonkey</command></term>
449 <listitem>
450 <para>
451 is the Mozilla browser/email/newsgroup/chat client suite
452 </para>
453 <indexterm zone="seamonkey seamonkey-prog">
454 <primary sortas="b-seamonkey">seamonkey</primary>
455 </indexterm>
456 </listitem>
457 </varlistentry>
458 </variablelist>
459 </sect2>
460
461</sect1>
Note: See TracBrowser for help on using the repository browser.