source: xsoft/other/thunderbird.xml@ 5b0a978e

10.0 10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 5b0a978e was 5b0a978e, checked in by Ken Moffat <ken@…>, 3 years ago

Update notes on building in chroot, for
mozilla packages needing python multiprocessing.

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

  • Property mode set to 100644
File size: 15.1 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 thunderbird-download-http "&mozilla-http;/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;.source.tar.xz">
8 <!ENTITY thunderbird-download-ftp " ">
9 <!ENTITY thunderbird-md5sum "d339fe0af582b1681951028795274107">
10 <!ENTITY thunderbird-size "324 MB">
11 <!ENTITY thunderbird-buildsize "9.0 GB (150 MB installed)">
12 <!ENTITY thunderbird-time "25 SBU (on a 4-core machine)">
13 <!-- Removed the -j1 time because python and rust do not obey it, although
14 the C/C++ code appears to obey it -->
15]>
16
17<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
18 <?dbhtml filename="thunderbird.html" ?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Thunderbird-&thunderbird-version;</title>
26
27 <indexterm zone="thunderbird">
28 <primary sortas="a-Thunderbird">Thunderbird</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Thunderbird</title>
33
34 <para>
35 <application>Thunderbird</application> is a stand-alone mail/news client
36 based on the <application>Mozilla</application> codebase. It uses the
37 Gecko rendering engine to enable it to display and compose HTML emails.
38 </para>
39
40 &lfs91_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&thunderbird-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&thunderbird-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &thunderbird-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &thunderbird-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &thunderbird-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &thunderbird-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80<!-- <xref linkend="alsa-lib"/>, no mention in log -->
81 <xref linkend="autoconf213"/>,
82 <xref linkend="cbindgen"/>,
83 both <xref linkend="gtk3"/>
84 and <xref linkend="gtk2"/>,
85 <xref linkend="llvm"/>, <!-- Searched for and used a few times -->
86 <xref linkend="nodejs"/>,
87 <xref linkend="rust"/>,
88 <xref linkend="zip"/>,
89 <xref linkend="unzip"/>, and
90 <xref linkend="yasm"/>
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <xref linkend="icu"/>,
96 <xref linkend="libevent"/>,
97<!-- Fails to build with version 1.8.0
98 <xref linkend="libvpx"/>,-->
99 <xref linkend="nspr"/>,
100 <xref linkend="nss"/>, and
101 <xref linkend="sqlite"/>
102 </para>
103
104 <note>
105 <para>
106 If you don't install recommended dependencies,
107 then internal copies of those packages will
108 be used. They might be tested to work, but
109 they can be out of date or contain security
110 holes.
111 </para>
112 </note>
113
114 <bridgehead renderas="sect4">Optional</bridgehead>
115 <para role="optional">
116 <!-- <xref linkend="curl"/>, not in build log-->
117 <xref linkend="cyrus-sasl"/>,
118 <xref linkend="dbus-glib"/>,
119 <xref linkend="doxygen"/>,
120 <xref linkend="GConf"/>,
121 <!--<xref linkend="gst10-plugins-base"/> (with
122 <xref linkend="gst10-plugins-good"/> and
123 <xref linkend="gst10-libav"/> at runtime),-->
124 <!-- <xref linkend="openjdk"/>, not in build log -->
125 <xref linkend="pulseaudio"/>,
126 <xref linkend="startup-notification"/>,
127 <xref linkend="wget"/>, and
128 <xref linkend="wireless_tools"/>
129 </para>
130
131 <para condition="html" role="usernotes">
132 User Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
133 </para>
134 </sect2>
135
136 <sect2 role="installation">
137 <title>Installation of Thunderbird</title>
138
139 <note>
140 <para>
141 The build process for Thunderbird can use 8GB+ of RAM when linking.
142 Make sure that you have adequate swap or RAM before continuing.
143 </para>
144 </note>
145
146 <para>
147 The configuration of <application>Thunderbird</application> is
148 accomplished by creating a <filename>mozconfig</filename> file containing
149 the desired configuration options. A default
150 <filename>mozconfig</filename> is created below. To see the entire list
151 of available configuration options (and a brief description of each),
152 issue <command>mozilla/configure --help</command>. Create the file with
153 the following command:
154 </para>
155
156<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
157<literal># If you have a multicore machine, all cores will be used.
158# The option below may cause parts of the build to only use one core
159# if you want to use a smaller number of jobs:
160#mk_add_options MOZ_MAKE_FLAGS="-j1"
161
162
163# If you have installed dbus-glib, comment out this line:
164ac_add_options --disable-dbus
165
166# If you have installed wireless-tools comment out this line:
167ac_add_options --disable-necko-wifi
168
169# Uncomment these lines if you have installed optional dependencies:
170#ac_add_options --enable-startup-notification
171
172# Comment out following option if you have PulseAudio installed
173ac_add_options --disable-pulseaudio
174
175# Comment out following option if you have gconf installed
176ac_add_options --disable-gconf
177
178# If you want to compile the Mozilla Calendar, uncomment this line:
179#ac_add_options --enable-calendar
180
181# Comment out following options if you have not installed
182# recommended dependencies:
183ac_add_options --enable-system-sqlite
184ac_add_options --with-system-libevent
185ac_add_options --with-system-nspr
186ac_add_options --with-system-nss
187ac_add_options --with-system-icu
188<!--Not with libvpx-1.8.0 or later
189ac_add_options - -with-system-libvpx
190====
191These do not seem to be needed any more
192# Set CFLAGS and CXXFLAGS to prevent segfaults due to aggressive
193# optimizations in GCC-6:
194export CFLAGS+=" -fno-delete-null-pointer-checks -fno-lifetime-dse -fno-schedule-insns2"
195export CXXFLAGS+=" -fno-delete-null-pointer-checks -fno-lifetime-dse -fno-schedule-insns2"
196-->
197# The elf-hack causes failed builds on clang-9.0.1 with some CFLAGS including
198# -march=native on Ryzen. It is supposed to improve startup time and it shrinks
199# libxul.so by a few MB - Uncomment this if your build is affected.
200#ac_add_options --disable-elf-hack
201
202# The BLFS editors recommend not changing anything below this line:
203ac_add_options --prefix=/usr
204ac_add_options --enable-application=comm/mail
205
206ac_add_options --disable-crashreporter
207ac_add_options --disable-updater
208ac_add_options --disable-debug
209ac_add_options --disable-tests
210
211ac_add_options --enable-optimize=-O2
212ac_add_options --enable-strip
213ac_add_options --enable-install-strip
214
215ac_add_options --enable-official-branding
216
217ac_add_options --enable-system-ffi
218ac_add_options --enable-system-pixman
219
220ac_add_options --with-system-bz2
221ac_add_options --with-system-jpeg
222ac_add_options --with-system-png
223ac_add_options --with-system-zlib</literal>
224EOF</userinput></screen>
225
226 <para>
227 Compile <application>Thunderbird</application> by issuing the following
228 commands:
229 </para>
230
231 <note>
232 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
233 href="../../xincludes/mozshm.xml"/>
234
235 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
236 href="../../xincludes/mozmach.xml"/>
237
238 </note>
239<!--
240 <para>
241 First, disable failure caused by undocumented rust macros:
242 </para>
243
244<screen><userinput remap="pre">sed -i -e '/#!\[deny(missing_docs)\]/d' servo/components/style/lib.rs &amp;&amp;
245sed -i -e 's/#!\[deny(unsafe_code, missing_docs)\]/#!\[deny(unsafe_code)\]/g' servo/components/style_traits/lib.rs</userinput></screen>
246
247 <para>
248 Remove a function definition, which is incompatible with the one in
249 glibc-2.30:
250 </para>
251
252<screen><userinput>sed -i -e '/pid_t gettid/s@^@//@' tools/profiler/core/platform.h</userinput></screen>
253
254 <para>
255 Next, build the package:
256 </para>
257-->
258<screen><userinput>./mach build</userinput></screen>
259
260 <para>
261 This package does not come with a test suite.
262 </para>
263
264 <para>
265 Install <application>Thunderbird</application> by running the following
266 commands as the <systemitem class="username">root</systemitem> user:
267 </para>
268
269<screen role="root"><userinput>./mach install</userinput></screen>
270
271<!-- thunderbuild directory does not exist anymore. Leaving as comment,
272in case an editor figures out how to install the development environment.
273 <para>
274 The above instruction just installs the parts you need to run
275 <application>Thunderbird</application>. Alternatively, if you want to
276 install the full <application>Thunderbird</application> development
277 environment, run the following command as the
278 <systemitem class="username">root</systemitem> user:
279 </para>
280
281<screen role="root"><userinput>make -C thunderbuild install</userinput></screen>
282-->
283 </sect2>
284
285 <sect2 role="commands">
286 <title>Command Explanations</title>
287<!-- might be necessary
288 <para>
289 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
290 version of thunderbird, an old bug has reappeared in 32-bit builds. With
291 optimization, the install fails with a Python error. This command will
292 fix i686 builds and preserve the optimization on x86_64.
293 </para>
294
295 <para>
296 <command>export CFLAGS= ... export CXXFLAGS= ...</command>: These
297 settings work around code which gcc6 would otherwise regard as
298 out-of-specification and allow it to produce a working program.
299 </para>-->
300
301 <para>
302 <command>./mach build</command>: <application>Thunderbird</application>
303 now uses this <application>python2</application> script to run the
304 build and install.
305 </para>
306
307 <para>
308 <option>./mach build --verbose</option>: Use this alternative if you
309 need details of which files are being compiled, together with any C or
310 C++ flags being used.
311 </para>
312
313 </sect2>
314
315 <sect2 role="configuration">
316 <title>Configuring Thunderbird</title>
317
318 <sect3><title>Configuration Information</title>
319
320 <para>
321 If your Window or Desktop Manager does not allow you to configure a
322 default browser, you can add a configuration parameter to
323 <application>Thunderbird</application> so that a browser will start when
324 you click on an Internet/intranet/local URL. The procedure to check
325 or modify any of the configuration parameters is quite simple and the
326 instructions here can be used to view or modify any of the parameters.
327 </para>
328
329 <para>
330 First, open the configuration dialog by opening the <quote>Edit</quote>
331 drop-down menu. Choose <quote>Preferences</quote> and then click on the
332 <quote>Advanced</quote> icon on the top menu bar. Choose the
333 <quote>General</quote> tab and click on the <quote>Config Editor</quote>
334 button. This will display a list of the configuration preferences and
335 information related to each one. You can use the <quote>Filter:</quote>
336 bar to enter search criteria and narrow down the listed items. Changing
337 a preference can be done using two methods. One, if the preference has a
338 boolean value (True/False), simply double-click on the preference to
339 toggle the value and two, for other preferences simply right-click on
340 the desired line, choose <quote>Modify</quote> from the menu and change
341 the value. Creating new preference items is accomplished in the same
342 way, except choose <quote>New</quote> from the menu and provide the
343 desired data into the fields when prompted.
344 </para>
345
346 <para>
347 The configuration preference item you need to check so that
348 <application>Thunderbird</application> uses a specified browser is the
349 <parameter>network.protocol-handler.app.http</parameter> which should be
350 set to the path of the desired browser, e.g.
351 <option>/usr/bin/firefox</option>.
352 </para>
353
354 <tip>
355 <para>
356 There is a multitude of configuration parameters you can tweak to
357 customize <application>Thunderbird</application>. A very extensive,
358 but not so up-to-date list of these parameters can be found at
359 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
360 </para>
361 </tip>
362
363 <para>
364
365 If you use a desktop environment such as <application>GNOME</application>
366 or <application>KDE</application>, a desktop file
367 <filename>thunderbird.desktop</filename> may be created, in order to
368 include a <quote><application>Thunderbird</application></quote> entry in
369 the menu. If you didn't enable
370 <application>startup-notification</application> in your mozconfig, then
371 change the StartupNotify line to false. Run the following commands as the
372 <systemitem class="username">root</systemitem> user:
373
374 </para>
375
376<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
377
378cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
379<literal>[Desktop Entry]
380Name=Thunderbird Mail
381Comment=Send and receive mail with Thunderbird
382GenericName=Mail Client
383Exec=thunderbird %u
384Terminal=false
385Type=Application
386Icon=thunderbird
387Categories=Network;Email;
388MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
389StartupNotify=true</literal>
390EOF
391
392ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
393 /usr/share/pixmaps/thunderbird.png</userinput></screen>
394 </sect3>
395 </sect2>
396
397 <sect2 role="content">
398 <title>Contents</title>
399
400 <segmentedlist>
401 <segtitle>Installed Program</segtitle>
402 <segtitle>Installed Libraries</segtitle>
403 <segtitle>Installed Directory</segtitle>
404
405 <seglistitem>
406 <seg>
407 thunderbird
408 </seg>
409 <seg>
410 libldap60.so, libldif60.so, liblgpllibs.so, libmozgtk.so,
411 libmozsandbox.so, libprldap60.so, and libxul.so
412 </seg>
413 <seg>
414 /usr/lib/thunderbird
415 </seg>
416 </seglistitem>
417 </segmentedlist>
418
419 <variablelist>
420 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
421 <?dbfo list-presentation="list"?>
422 <?dbhtml list-presentation="table"?>
423
424 <varlistentry id="thunderbird-prog">
425 <term><command>thunderbird</command></term>
426 <listitem>
427 <para>
428 is <application>Mozilla</application>'s email and newsgroup client.
429 </para>
430 <indexterm zone="thunderbird thunderbird-prog">
431 <primary sortas="b-thunderbird">thunderbird</primary>
432 </indexterm>
433 </listitem>
434 </varlistentry>
435
436 </variablelist>
437
438 </sect2>
439
440</sect1>
Note: See TracBrowser for help on using the repository browser.