source: xsoft/other/thunderbird.xml@ 6be5958a

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6be5958a was 6be5958a, checked in by Ken Moffat <ken@…>, 15 months ago

Thunderbird: Remove the --disable-dbus option.

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

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