source: xsoft/other/thunderbird.xml

trunk
Last change on this file was 62beded, checked in by Pierre Labastie <pierre.labastie@…>, 11 days ago

Update to thunderbird-102.1.0

  • Property mode set to 100644
File size: 16.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 "d74f745a8a4d05b0810a45a5362b9c7c">
10 <!ENTITY thunderbird-size "479 MB">
11 <!ENTITY thunderbird-buildsize "7.3 GB (202 MB installed)">
12 <!ENTITY thunderbird-time "23 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 <date>$Date$</date>
22 </sect1info>
23
24 <title>Thunderbird-&thunderbird-version;</title>
25
26 <indexterm zone="thunderbird">
27 <primary sortas="a-Thunderbird">Thunderbird</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Thunderbird</title>
32
33 <para>
34 <application>Thunderbird</application> is a stand-alone mail/news client
35 based on the <application>Mozilla</application> codebase. It uses the
36 Gecko rendering engine to enable it to display and compose HTML emails.
37 </para>
38
39 &lfs111_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&thunderbird-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&thunderbird-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &thunderbird-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &thunderbird-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &thunderbird-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &thunderbird-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75<!--<bridgehead renderas="sect3">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required patch:
80 <ulink url="&patch-root;/thunderbird-&thunderbird-version;-gcc12_fix-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>-->
84
85 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required">
89<!-- <xref linkend="alsa-lib"/>, no mention in log -->
90 <xref linkend="autoconf213"/>,
91 <xref linkend="cbindgen"/>,
92 <xref linkend="dbus-glib"/>,
93 both <xref linkend="gtk3"/>
94 and <xref linkend="gtk2"/>,
95 <xref linkend="llvm"/> including clang, <!-- Searched for and used a few times -->
96 <xref linkend="nodejs"/>,
97 <xref linkend="pulseaudio"/> (or <xref linkend="alsa-lib"/> if you edit
98 the mozconfig; although it is now deprecated by mozilla),
99 <xref linkend="python3"/> (rebuilt with the sqlite module),
100 <xref linkend="startup-notification"/>,
101 <xref linkend="zip"/>,
102 <xref linkend="unzip"/>, and
103 <xref linkend="yasm"/>
104 </para>
105
106 <bridgehead renderas="sect4">Recommended</bridgehead>
107 <para role="recommended">
108 <xref linkend="icu"/>,
109 <xref linkend="libevent"/>,
110 <xref linkend="libvpx"/>,
111 <xref linkend="nasm"/>,
112 <xref linkend="nspr"/>, and
113 <xref linkend="nss"/>
114 </para>
115
116 <note>
117 <para>
118 If you don't install recommended dependencies,
119 then internal copies of those packages will
120 be used. They might be tested to work, but
121 they can be out of date or contain security
122 holes.
123 </para>
124 </note>
125
126 <bridgehead renderas="sect4">Optional</bridgehead>
127 <para role="optional">
128 <!-- <xref linkend="curl"/>, not in build log-->
129 <xref linkend="cyrus-sasl"/>,
130 <xref linkend="doxygen"/>,
131 <xref linkend="GConf"/>,
132 <!--<xref linkend="gst10-plugins-base"/> (with
133 <xref linkend="gst10-plugins-good"/> and
134 <xref linkend="gst10-libav"/> at runtime),-->
135 <!-- <xref linkend="openjdk"/>, not in build log -->
136 <!--<xref linkend="pulseaudio"/>,-->
137 <xref linkend="wget"/>,
138 <xref linkend="wireless_tools"/>, and
139 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
140 </para>
141
142 <para condition="html" role="usernotes">
143 User Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
144 </para>
145 </sect2>
146
147 <sect2 role="installation">
148 <title>Installation of Thunderbird</title>
149
150 <note>
151 <para>
152 The build process for Thunderbird can use 8GB+ of RAM when linking.
153 Make sure that you have adequate swap or RAM before continuing.
154 </para>
155 </note>
156
157 <para>
158 The configuration of <application>Thunderbird</application> is
159 accomplished by creating a <filename>mozconfig</filename> file containing
160 the desired configuration options. A default
161 <filename>mozconfig</filename> is created below. To see the entire list
162 of available configuration options (and a brief description of each),
163 issue <command>mozilla/configure --help</command>. Create the file with
164 the following command:
165 </para>
166
167<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
168<literal># If you have a multicore machine, all cores will be used.
169
170# If you have installed wireless-tools comment out this line:
171ac_add_options --disable-necko-wifi
172
173# Uncomment the following option if you have not installed PulseAudio
174#ac_add_options --disable-pulseaudio
175# and uncomment this if you installed alsa-lib instead of PulseAudio
176#ac_add_options --enable-alsa
177<!-- always built in versions 78+. The option is a noop
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 --with-system-libevent
184ac_add_options --with-system-libvpx
185ac_add_options --with-system-nspr
186ac_add_options --with-system-nss
187ac_add_options --with-system-icu
188
189# The elf-hack causes failed installs on some machines.
190# It is supposed to improve startup time and it shrinks libxul.so
191# by a few MB - comment this if you know your machine is not affected.
192ac_add_options --disable-elf-hack
193
194# The BLFS editors recommend not changing anything below this line:
195ac_add_options --prefix=/usr
196ac_add_options --enable-application=comm/mail
197
198ac_add_options --disable-crashreporter
199ac_add_options --disable-updater
200ac_add_options --disable-debug
201ac_add_options --disable-debug-symbols
202ac_add_options --disable-tests
203
204ac_add_options --enable-optimize=-O2
205ac_add_options --enable-linker=gold
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
217
218# Using sandboxed wasm libraries has been moved to all builds instead
219# of only mozilla automation builds. It requires extra llvm packages
220# and was reported to seriously slow the build. Disable it.
221ac_add_options --without-wasm-sandboxed-libraries</literal>
222EOF</userinput></screen>
223
224
225<!--<para>
226 Apply a patch which allows compilation on systems with gcc-12:
227 </para>
228
229<screen><userinput remap="pre">patch -Np1 -i ../thunderbird-&thunderbird-version;-gcc12_fix-1.patch</userinput></screen>-->
230
231 <para>
232 A change in cbindgen-0.24.2 causes a symbol to now be output by
233 cbindgen, but it has already been defined in a header. This sed
234 prevents the build eventually failing:
235 </para>
236
237<screen><userinput>sed -i '/ROOT_CLIP_CHAIN/d' gfx/webrender_bindings/webrender_ffi.h</userinput></screen>
238
239<!-- applying this for 11.1: upstream haven't made their mind yet
240 https://bugzilla.mozilla.org/show_bug.cgi?id=1729459
241 Still not fixed in 102.1. -->
242 <para>
243 If building on a 32 bit machine, the following sed works around
244 an issue with an incompatible <quote>double</quote> type in one
245 header file:
246 </para>
247
248<screen><userinput>case "$(uname -m)" in
249 i?86) sed -e '/typedef[ ]*double/s/double/long double/' \
250 -i modules/fdlibm/src/math_private.h ;;
251esac</userinput></screen>
252
253 <para>
254 Now invoke the Python <command>mach</command> script to compile
255 <application>Thunderbird</application>:
256 </para>
257
258 <note>
259 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
260 href="../../xincludes/mozshm.xml"/>
261
262 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
263 href="../../xincludes/mozmach.xml"/>
264
265 </note>
266
267<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system &amp;&amp;
268export MOZBUILD_STATE_PATH=./mozbuild &amp;&amp;
269./mach configure &amp;&amp;
270./mach build</userinput></screen>
271
272 <para>
273 This package does not come with a test suite.
274 </para>
275
276 <para>
277 Install <application>Thunderbird</application> by running the following
278 commands as the <systemitem class="username">root</systemitem> user:
279 </para>
280
281<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system ./mach install</userinput></screen>
282<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
283 <para>
284 Empty the environment variables which were set above:
285 </para>
286
287<screen><userinput>unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE MOZBUILD_STATE_PATH</userinput></screen>
288
289 </sect2>
290
291 <sect2 role="commands">
292 <title>Command Explanations</title>
293<!-- might be necessary, we need to verify this.
294 <para>
295 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
296 version of thunderbird, an old bug has reappeared in 32-bit builds. With
297 optimization, the install fails with a Python error. This command will
298 fix i686 builds and preserve the optimization on x86_64.
299 </para>-->
300
301 <para>
302 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system</command>: Use the
303 system python to create a virtual environment for <command>mach</command>
304 without downloading any python wheels.
305 </para>
306
307 <para>
308 <command>./mach configure</command>: This validates the supplied
309 dependencies and the <filename>mozconfig</filename>.
310 </para>
311
312 <para>
313 <option>./mach build --verbose</option>: Use this alternative if you
314 need details of which files are being compiled, together with any C or
315 C++ flags being used.
316 </para>
317
318 <para>
319 <option>./mach build -jN</option>: The build should, by default, use
320 all the online CPU cores. If using all the cores causes the build to swap
321 because you have insufficient memory, using fewer cores can be faster.
322 </para>
323
324 <para>
325 <parameter><envar>CC=gcc CXX=g++</envar></parameter>: BLFS used to
326 prefer to use gcc and g++ instead of upstream's defaults of the
327 <application>clang</application> programs. With the release of
328 gcc-12 the build takes longer with gcc and g++, primarily because
329 of extra warnings, and is bigger. Set these environment variables
330 <emphasis>before you run the configure script</emphasis>
331 if you wish to continue to use gcc, g++.
332 </para>
333
334 </sect2>
335
336 <sect2 role="configuration">
337 <title>Configuring Thunderbird</title>
338
339 <sect3><title>Configuration Information</title>
340
341 <para>
342 If your Window or Desktop Manager does not allow you to configure a
343 default browser, you can add a configuration parameter to
344 <application>Thunderbird</application> so that a browser will start when
345 you click on an Internet/intranet/local URL. The procedure to check
346 or modify any of the configuration parameters is quite simple and the
347 instructions here can be used to view or modify any of the parameters.
348 </para>
349
350 <para>
351 First, open the configuration dialog by opening the <quote>Edit</quote>
352 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
353 to the bottom of the page. Then, click the <quote>Config Editor</quote>
354 button. Click on the <quote>I accept the risk!</quote> button.
355 This will display a list of the configuration preferences and
356 information related to each one. You can use the <quote>Filter:</quote>
357 bar to enter search criteria and narrow down the listed items. Changing
358 a preference can be done using two methods. One, if the preference has a
359 boolean value (True/False), simply double-click on the preference to
360 toggle the value and two, for other preferences simply right-click on
361 the desired line, choose <quote>Modify</quote> from the menu and change
362 the value. Creating new preference items is accomplished in the same
363 way, except choose <quote>New</quote> from the menu and provide the
364 desired data into the fields when prompted.
365 </para>
366
367 <para>
368 The configuration preference item you need to check so that
369 <application>Thunderbird</application> uses a specified browser is the
370 <parameter>network.protocol-handler.app.http</parameter> which should be
371 set to the path of the desired browser, e.g.
372 <option>/usr/bin/firefox</option>.
373 </para>
374
375 <tip>
376 <para>
377 There is a multitude of configuration parameters you can tweak to
378 customize <application>Thunderbird</application>. A very extensive,
379 but not so up-to-date list of these parameters can be found at
380 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
381 </para>
382 </tip>
383
384 <para>
385
386 If you use a desktop environment such as <application>GNOME</application>
387 or <application>KDE</application>, a desktop file
388 <filename>thunderbird.desktop</filename> may be created, in order to
389 include a <quote><application>Thunderbird</application></quote> entry in
390 the menu. <!--If you didn't enable
391 <application>startup-notification</application> in your mozconfig, then
392 change the StartupNotify line to false.--> Run the following commands as the
393 <systemitem class="username">root</systemitem> user:
394
395 </para>
396
397<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
398
399cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
400<literal>[Desktop Entry]
401Name=Thunderbird Mail
402Comment=Send and receive mail with Thunderbird
403GenericName=Mail Client
404Exec=thunderbird %u
405Terminal=false
406Type=Application
407Icon=thunderbird
408Categories=Network;Email;
409MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
410StartupNotify=true</literal>
411EOF
412
413ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
414 /usr/share/pixmaps/thunderbird.png</userinput></screen>
415 </sect3>
416 </sect2>
417
418 <sect2 role="content">
419 <title>Contents</title>
420
421 <segmentedlist>
422 <segtitle>Installed Program</segtitle>
423 <segtitle>Installed Libraries</segtitle>
424 <segtitle>Installed Directory</segtitle>
425
426 <seglistitem>
427 <seg>
428 thunderbird
429 </seg>
430 <seg>
431 Numerous libraries and modules in the /usr/lib/thunderbird directory
432 </seg>
433 <seg>
434 /usr/lib/thunderbird
435 </seg>
436 </seglistitem>
437 </segmentedlist>
438
439 <variablelist>
440 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
441 <?dbfo list-presentation="list"?>
442 <?dbhtml list-presentation="table"?>
443
444 <varlistentry id="thunderbird-prog">
445 <term><command>thunderbird</command></term>
446 <listitem>
447 <para>
448 is <application>Mozilla</application>'s email and newsgroup client
449 </para>
450 <indexterm zone="thunderbird thunderbird-prog">
451 <primary sortas="b-thunderbird">thunderbird</primary>
452 </indexterm>
453 </listitem>
454 </varlistentry>
455
456 </variablelist>
457
458 </sect2>
459
460</sect1>
Note: See TracBrowser for help on using the repository browser.