source: xsoft/graphweb/seamonkey.xml@ 94b42903

10.0 10.1 11.0 11.1 11.2 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 94b42903 was 94b42903, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Archive openssl-1.1.x. Moved to LFS.
Update to v4l-utils-1.14.2.
Update to vlc-3.0.0.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19748 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 15.5 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 "c0ea3b8705975a12d9c4af966db1649f">
10 <!ENTITY seamonkey-size "219 MB">
11 <!ENTITY seamonkey-buildsize "4.6 GB (262 MB installed with devel env)">
12 <!ENTITY seamonkey-time "17 SBU (using parallelism=4)">
13]>
14
15<sect1 id="seamonkey" xreflabel="SeaMonkey-&seamonkey-version;">
16 <?dbhtml filename="seamonkey.html" ?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>SeaMonkey-&seamonkey-version;</title>
24
25 <indexterm zone="seamonkey">
26 <primary sortas="a-SeaMonkey">SeaMonkey</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to SeaMonkey</title>
31
32 <para>
33 <application>SeaMonkey</application> is a browser suite, the Open Source
34 sibling of <application>Netscape</application>. It includes the browser,
35 composer, mail and news clients, and an IRC client. It is the follow-on
36 to the Mozilla browser suite.
37 </para>
38
39 <para>
40 The Mozilla project also hosts two subprojects that aim to satisfy the
41 needs of users who don't need the complete browser suite or prefer to have
42 separate applications for browsing and e-mail. These subprojects are
43 <xref linkend="firefox"/> and <xref linkend="thunderbird"/>. Both are
44 based on the <application>Mozilla</application> source code.
45 </para>
46
47 &lfs81_checked;
48
49 <bridgehead renderas="sect3">Package Information</bridgehead>
50 <itemizedlist spacing="compact">
51 <listitem>
52 <para>
53 Download (HTTP): <ulink url="&seamonkey-download-http;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download (FTP): <ulink url="&seamonkey-download-ftp;"/>
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download MD5 sum: &seamonkey-md5sum;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Download size: &seamonkey-size;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated disk space required: &seamonkey-buildsize;
74 </para>
75 </listitem>
76 <listitem>
77 <para>
78 Estimated build time: &seamonkey-time;
79 </para>
80 </listitem>
81 </itemizedlist>
82<!--
83 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
84 <itemizedlist spacing="compact">
85 <listitem>
86 <para>
87 Required patch if using gcc-6 or later
88 <ulink url="&patch-root;/seamonkey-&seamonkey-version;-gcc6-1.patch"/>
89 </para>
90 </listitem>
91 </itemizedlist>
92-->
93 <note>
94 <para>
95 The tarball
96 <emphasis>seamonkey-&seamonkey-version;.source.tar.xz</emphasis> will
97 untar to <emphasis>seamonkey-&seamonkey-version;</emphasis> directory.
98 </para>
99 </note>
100
101 <bridgehead renderas="sect3">SeaMonkey Dependencies</bridgehead>
102
103 <bridgehead renderas="sect4">Required</bridgehead>
104 <para role="required">
105 <xref linkend="alsa-lib"/>,
106 <xref linkend="autoconf213"/>,
107 both <xref linkend="gtk2"/> and <xref linkend="gtk3"/>,
108 <xref linkend="unzip"/>,
109 <xref linkend="yasm"/>, and
110 <xref linkend="zip"/>
111 </para>
112
113 <bridgehead renderas="sect4">Recommended</bridgehead>
114 <para role="recommended">
115 <xref linkend="icu"/>,
116 <xref linkend="libevent"/>,
117 <xref linkend="libvpx"/>,
118 <xref linkend="nspr"/>,
119 <xref linkend="nss"/>, and
120 <xref linkend="sqlite"/>
121 </para>
122<!--
123 <bridgehead renderas="sect4">Optional</bridgehead>
124 <para role="optional">
125 <xref linkend="sqlite"/> (not recommended due to potential
126 security concerns)
127 </para>
128-->
129 <note>
130 <para>
131 If you don't install recommended dependencies, then internal copies of
132 those packages will be used. They might be tested to work, but they can
133 be out of date or contain security holes.
134 </para>
135 </note>
136<!--
137 <note>
138 <para>
139 You must have installed <application>Openssl</application> before
140 <application>Python 2</application> or the build system will quickly
141 fail with output including "ImportError: cannot import name
142 HTTPSHandler". If you are in any doubt about this (e.g. upgrading from
143 an older version of Seamonkey), check if
144 <filename>/usr/lib/python&python2-majorver;/lib-dynload/_ssl.so</filename>
145 exists. If it does not, reinstall <xref linkend="python2"/> (after
146 installing <xref linkend="openssl"/>. The latest version of any
147 <emphasis>currently maintained</emphasis> version of Openssl should be
148 satisfactory if already installed.
149 </para>
150 </note>
151-->
152 <bridgehead renderas="sect4">Optional</bridgehead>
153 <para role="optional">
154 <xref linkend="curl"/>,
155 <xref linkend="dbus-glib"/>,
156 <xref linkend="doxygen"/>,
157 <xref linkend="GConf"/>,
158 <xref linkend="gst10-plugins-base"/> (and other plugins, only for tests),
159 <xref linkend="openjdk"/>,
160 <xref linkend="pulseaudio"/>,
161 <xref linkend="startup-notification"/>,
162 <xref linkend="valgrind"/>,
163 <xref linkend="wget"/>,
164 <xref linkend="wireless_tools"/>, and
165 <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>
166 </para>
167
168 <para condition="html" role="usernotes">
169 User Notes: <ulink url="&blfs-wiki;/seamonkey"/>
170 </para>
171
172 </sect2>
173
174 <sect2 role="installation">
175 <title>Installation of SeaMonkey</title>
176
177 <para>
178 The configuration of <application>SeaMonkey</application> is accomplished
179 by creating a <filename>mozconfig</filename> file containing the desired
180 configuration options. A default <filename>mozconfig</filename> file is
181 created below. To see the entire list of available configuration options
182 (and an abbreviated description of each one), issue
183 <command>./configure --help</command>. You may also wish to review the
184 entire file and uncomment any other desired options. Create the file by
185 issuing the following command:
186 </para>
187
188<screen><?dbfo keep-together="auto"?><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
189<literal># If you have a multicore machine, all cores will be used by default.
190# If desired, you can reduce the number of cores used, e.g. to 1, by
191# uncommenting the next line and setting a valid number of CPU cores.
192#mk_add_options MOZ_MAKE_FLAGS="-j1"
193
194# If you have installed DBus-Glib comment out this line:
195ac_add_options --disable-dbus
196
197# If you have installed dbus-glib, and you have installed (or will install)
198# wireless-tools, and you wish to use geolocation web services, comment out
199# this line
200ac_add_options --disable-necko-wifi
201
202# Uncomment these lines if you have installed optional dependencies:
203#ac_add_options --enable-system-hunspell
204#ac_add_options --enable-startup-notification
205
206# Comment out the following option if you have PulseAudio installed
207ac_add_options --disable-pulseaudio
208
209# Comment out following option if you have gconf installed
210ac_add_options --disable-gconf
211
212# Comment out following options if you have not installed
213# recommended dependencies:
214ac_add_options --enable-system-sqlite
215ac_add_options --with-system-libevent
216ac_add_options --with-system-libvpx
217ac_add_options --with-system-nspr
218ac_add_options --with-system-nss
219ac_add_options --with-system-icu
220
221<!-- seems OK with icu-60, seamonkey-2.49
222# Use the internal version of icu due to execution problems-->
223
224# The BLFS editors recommend not changing anything below this line:
225ac_add_options --prefix=/usr
226ac_add_options --enable-application=suite
227
228ac_add_options --disable-crashreporter
229ac_add_options --disable-updater
230ac_add_options --disable-tests
231
232ac_add_options --enable-optimize="-O2"
233ac_add_options --enable-strip
234ac_add_options --enable-install-strip
235
236ac_add_options --enable-gio
237ac_add_options --enable-official-branding
238ac_add_options --enable-safe-browsing
239ac_add_options --enable-url-classifier
240
241# Use internal cairo due to reports of unstable execution with
242# system cairo
243#ac_add_options --enable-system-cairo
244ac_add_options --enable-system-ffi
245ac_add_options --enable-system-pixman
246
247ac_add_options --with-pthreads
248
249ac_add_options --with-system-bz2
250ac_add_options --with-system-jpeg
251ac_add_options --with-system-png
252ac_add_options --with-system-zlib</literal>
253EOF</userinput></screen>
254
255 <note><para>
256 If you are compiling <application>SeaMonkey</application> in chroot, make
257 sure you have the <envar>SHELL</envar> environment variable set or prepend
258 <envar>SHELL=/bin/sh</envar> to the first make command below.
259 </para></note>
260
261 <para>
262 Compile <application>SeaMonkey</application> by running the following
263 commands:
264 </para>
265
266<screen><userinput>CFLAGS_HOLD=$CFLAGS &amp;&amp;
267CXXFLAGS_HOLD=$CXXFLAGS &amp;&amp;
268EXTRA_FLAGS=" -fno-delete-null-pointer-checks -fno-lifetime-dse -fno-schedule-insns2" &amp;&amp;
269export CFLAGS+=$EXTRA_FLAGS &amp;&amp;
270export CXXFLAGS+=$EXTRA_FLAGS &amp;&amp;
271unset EXTRA_FLAGS &amp;&amp;
272
273make -f client.mk</userinput></screen>
274
275 <para>
276 This package does not come with a test suite.
277 </para>
278
279 <para>
280 Install <application>SeaMonkey</application> by issuing the following
281 commands as the <systemitem class="username">root</systemitem> user:
282 </para>
283
284<screen role="root"><userinput>make -f client.mk install INSTALL_SDK= &amp;&amp;
285chown -R 0:0 /usr/lib/seamonkey-&seamonkey-version; &amp;&amp;
286
287cp -v $(find -name seamonkey.1 | head -n1) /usr/share/man/man1</userinput></screen>
288
289 <para>
290 Set the compilation flags back to their original values:
291 </para>
292
293<screen><userinput>export CFLAGS=$CFLAGS_HOLD &amp;&amp;
294export CXXFLAGS=$CXXFLAGS_HOLD &amp;&amp;
295unset CFLAGS_HOLD CXXFLAGS_HOLD</userinput></screen>
296
297 <bridgehead renderas="sect3" id="devel-seamonkey" xreflabel="SeaMonkey">
298 All the Development Libraries and Headers
299 </bridgehead>
300
301 <para>
302 If you want to install the full <application>SeaMonkey</application>
303 development environment, as the
304 <systemitem class="username">root</systemitem> user:
305 </para>
306
307<screen role="root"><userinput>make -C obj* install</userinput></screen>
308
309 <note>
310 <para>
311 The build directory is set by the make procedure and is dependent on
312 the system architecture, but the directory name starts with 'obj'.
313 </para>
314 </note>
315
316 </sect2>
317
318 <sect2 role="commands">
319 <title>Command Explanations</title>
320
321 <para>
322 <command>export CFLAGS= ... export CXXFLAGS= ...</command>: These
323 settings work around code which gcc6 and later would otherwise regard as
324 out-of-specification and allow it to produce a working program.
325 </para>
326
327 <para>
328 <command>make -f client.mk</command>: Mozilla products are packaged to
329 allow the use of a configuration file which can be used to pass the
330 configuration settings to the <command>configure</command> command.
331 <command>make</command> uses the <filename>client.mk</filename> file to
332 get initial configuration and setup parameters.
333 </para>
334
335 </sect2>
336
337 <sect2 role="configuration">
338 <title>Configuring SeaMonkey</title>
339
340 <para>
341 For installing various <application>SeaMonkey</application> plugins, refer
342 to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's PluginDoc
343 Project</ulink>.
344 </para>
345
346 <para>
347 Along with using the <quote>Preferences</quote> menu to configure
348 <application>SeaMonkey</application>'s options and preferences to suit
349 individual tastes, finer grain control of many options is only available
350 using a tool not available from the general menu system. To access this
351 tool, you'll need to open a browser window and enter
352 <systemitem role="url">about:config</systemitem> in the address bar. This
353 will display a list of the configuration preferences and information
354 related to each one. You can use the <quote>Filter:</quote> bar to enter
355 search criteria and narrow down the listed items. Changing a preference
356 can be done using two methods. One, if the preference has a boolean value
357 (True/False), simply double-click on the preference to toggle the value
358 and two, for other preferences simply right-click on the desired line,
359 choose <quote>Modify</quote> from the menu and change the value. Creating
360 new preference items is accomplished in the same way, except choose
361 <quote>New</quote> from the menu and provide the desired data into the
362 fields when prompted.
363 </para>
364
365 <tip>
366 <para>
367 There is a multitude of configuration parameters you can tweak to
368 customize <application>SeaMonkey</application>. A very extensive list of
369 these parameters can be found at
370 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
371 </para>
372 </tip>
373
374 <para>
375 If you use a desktop environment like <application>Gnome</application> or
376 <application>KDE</application> you may wish to create a
377 <filename>seamonkey.desktop</filename> file so that
378 <application>SeaMonkey</application> appears in the panel's menus. If you
379 didn't enable <application>Startup-Notification</application> in your
380 mozconfig change the StartupNotify line to false. As the
381 <systemitem class="username">root</systemitem> user:
382 </para>
383
384<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
385
386cat &gt; /usr/share/applications/seamonkey.desktop &lt;&lt; "EOF"
387[Desktop Entry]
388Encoding=UTF-8
389Type=Application
390Name=SeaMonkey
391Comment=The Mozilla Suite
392Icon=seamonkey
393Exec=seamonkey
394Categories=Network;GTK;Application;Email;Browser;WebBrowser;News;
395StartupNotify=true
396Terminal=false
397EOF
398
399ln -sfv /usr/lib/seamonkey-&seamonkey-version;/chrome/icons/default/seamonkey.png \
400 /usr/share/pixmaps</userinput></screen>
401 </sect2>
402
403 <sect2 role="content">
404 <title>Contents</title>
405
406 <segmentedlist>
407 <segtitle>Installed Programs</segtitle>
408 <segtitle>Installed Libraries</segtitle>
409 <segtitle>Installed Directory</segtitle>
410
411 <seglistitem>
412 <seg>seamonkey</seg>
413 <seg>
414 Numerous libraries, browser, and email/newsgroup components, plugins,
415 extensions, and helper modules installed in <filename
416 class="directory">/usr/lib/seamonkey-&seamonkey-version;</filename>
417 </seg>
418 <seg>
419 /usr/include/seamonkey-&seamonkey-version; (optional),
420 /usr/lib/seamonkey-&seamonkey-version;,
421 /usr/lib/seamonkey-devel-&seamonkey-version; (optional), and
422 /usr/share/idl/seamonkey-&seamonkey-version; (optional)
423 </seg>
424 </seglistitem>
425 </segmentedlist>
426
427 <variablelist>
428 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
429 <?dbfo list-presentation="list"?>
430 <?dbhtml list-presentation="table"?>
431
432 <varlistentry id="seamonkey-prog">
433 <term><command>seamonkey</command></term>
434 <listitem>
435 <para>
436 is the Mozilla browser/email/newsgroup/chat client suite.
437 </para>
438 <indexterm zone="seamonkey seamonkey-prog">
439 <primary sortas="b-seamonkey">seamonkey</primary>
440 </indexterm>
441 </listitem>
442 </varlistentry>
443 </variablelist>
444 </sect2>
445</sect1>
Note: See TracBrowser for help on using the repository browser.