source: xsoft/other/thunderbird.xml@ 8d2bafa9

11.2 trunk xry111/soup3
Last change on this file since 8d2bafa9 was 8d2bafa9, checked in by Pierre Labastie <pierre.labastie@…>, 3 months ago

Add --without-wasm-sandboxed-libraries to thunderbird too

  • Property mode set to 100644
File size: 16.3 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 "fc033aefff22c745284c12d648affa1d">
10 <!ENTITY thunderbird-size "480 MB">
11 <!ENTITY thunderbird-buildsize "7.4 GB (202 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 <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 make their mind yet
240 https://bugzilla.mozilla.org/show_bug.cgi?id=1729459
241 Still not fixed in 102.0. -->
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;
268./mach configure &amp;&amp;
269./mach build</userinput></screen>
270
271 <para>
272 This package does not come with a test suite.
273 </para>
274
275 <para>
276 Install <application>Thunderbird</application> by running the following
277 commands as the <systemitem class="username">root</systemitem> user:
278 </para>
279
280<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system ./mach install</userinput></screen>
281<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
282 <para>
283 Empty the environment variables which were set above:
284 </para>
285
286<screen><userinput>unset CC CXX MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE</userinput></screen>
287
288 </sect2>
289
290 <sect2 role="commands">
291 <title>Command Explanations</title>
292<!-- might be necessary, we need to verify this.
293 <para>
294 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
295 version of thunderbird, an old bug has reappeared in 32-bit builds. With
296 optimization, the install fails with a Python error. This command will
297 fix i686 builds and preserve the optimization on x86_64.
298 </para>-->
299
300 <para>
301 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system</command>: Use the
302 system python to create a virtual environment for <command>mach</command>
303 without downloading any python wheels.
304 </para>
305
306 <para>
307 <command>./mach configure</command>: This validates the supplied
308 dependencies and the <filename>mozconfig</filename>.
309 </para>
310
311 <para>
312 <option>./mach build --verbose</option>: Use this alternative if you
313 need details of which files are being compiled, together with any C or
314 C++ flags being used.
315 </para>
316
317 <para>
318 <option>./mach build -jN</option>: The build should, by default, use
319 all the online CPU cores. If using all the cores causes the build to swap
320 because you have insufficient memory, using fewer cores can be faster.
321 </para>
322
323 <para>
324 <parameter><envar>CC=gcc CXX=g++</envar></parameter>: BLFS used to
325 prefer to use gcc and g++ instead of upstream's defaults of the
326 <application>clang</application> programs. With the release of
327 gcc-12 the build takes longer with gcc and g++, primarily because
328 of extra warnings, and is bigger. Set these environment variables
329 <emphasis>before you run the configure script</emphasis>
330 if you wish to continue to use gcc, g++.
331 </para>
332
333 </sect2>
334
335 <sect2 role="configuration">
336 <title>Configuring Thunderbird</title>
337
338 <sect3><title>Configuration Information</title>
339
340 <para>
341 If your Window or Desktop Manager does not allow you to configure a
342 default browser, you can add a configuration parameter to
343 <application>Thunderbird</application> so that a browser will start when
344 you click on an Internet/intranet/local URL. The procedure to check
345 or modify any of the configuration parameters is quite simple and the
346 instructions here can be used to view or modify any of the parameters.
347 </para>
348
349 <para>
350 First, open the configuration dialog by opening the <quote>Edit</quote>
351 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
352 to the bottom of the page. Then, click the <quote>Config Editor</quote>
353 button. Click on the <quote>I accept the risk!</quote> button.
354 This will display a list of the configuration preferences and
355 information related to each one. You can use the <quote>Filter:</quote>
356 bar to enter search criteria and narrow down the listed items. Changing
357 a preference can be done using two methods. One, if the preference has a
358 boolean value (True/False), simply double-click on the preference to
359 toggle the value and two, for other preferences simply right-click on
360 the desired line, choose <quote>Modify</quote> from the menu and change
361 the value. Creating new preference items is accomplished in the same
362 way, except choose <quote>New</quote> from the menu and provide the
363 desired data into the fields when prompted.
364 </para>
365
366 <para>
367 The configuration preference item you need to check so that
368 <application>Thunderbird</application> uses a specified browser is the
369 <parameter>network.protocol-handler.app.http</parameter> which should be
370 set to the path of the desired browser, e.g.
371 <option>/usr/bin/firefox</option>.
372 </para>
373
374 <tip>
375 <para>
376 There is a multitude of configuration parameters you can tweak to
377 customize <application>Thunderbird</application>. A very extensive,
378 but not so up-to-date list of these parameters can be found at
379 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
380 </para>
381 </tip>
382
383 <para>
384
385 If you use a desktop environment such as <application>GNOME</application>
386 or <application>KDE</application>, a desktop file
387 <filename>thunderbird.desktop</filename> may be created, in order to
388 include a <quote><application>Thunderbird</application></quote> entry in
389 the menu. <!--If you didn't enable
390 <application>startup-notification</application> in your mozconfig, then
391 change the StartupNotify line to false.--> Run the following commands as the
392 <systemitem class="username">root</systemitem> user:
393
394 </para>
395
396<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
397
398cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
399<literal>[Desktop Entry]
400Name=Thunderbird Mail
401Comment=Send and receive mail with Thunderbird
402GenericName=Mail Client
403Exec=thunderbird %u
404Terminal=false
405Type=Application
406Icon=thunderbird
407Categories=Network;Email;
408MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
409StartupNotify=true</literal>
410EOF
411
412ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
413 /usr/share/pixmaps/thunderbird.png</userinput></screen>
414 </sect3>
415 </sect2>
416
417 <sect2 role="content">
418 <title>Contents</title>
419
420 <segmentedlist>
421 <segtitle>Installed Program</segtitle>
422 <segtitle>Installed Libraries</segtitle>
423 <segtitle>Installed Directory</segtitle>
424
425 <seglistitem>
426 <seg>
427 thunderbird
428 </seg>
429 <seg>
430 libldap60.so, libldif60.so, liblgpllibs.so, libmozgtk.so,
431 libmozsandbox.so, libmozsqlite3.so, libmozwayland.so,
432 libprldap60.so, librnp.so, and libxul.so, all in the
433 /usr/lib/thunderbird directory
434 </seg>
435 <seg>
436 /usr/lib/thunderbird
437 </seg>
438 </seglistitem>
439 </segmentedlist>
440
441 <variablelist>
442 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
443 <?dbfo list-presentation="list"?>
444 <?dbhtml list-presentation="table"?>
445
446 <varlistentry id="thunderbird-prog">
447 <term><command>thunderbird</command></term>
448 <listitem>
449 <para>
450 is <application>Mozilla</application>'s email and newsgroup client
451 </para>
452 <indexterm zone="thunderbird thunderbird-prog">
453 <primary sortas="b-thunderbird">thunderbird</primary>
454 </indexterm>
455 </listitem>
456 </varlistentry>
457
458 </variablelist>
459
460 </sect2>
461
462</sect1>
Note: See TracBrowser for help on using the repository browser.