source: xsoft/other/thunderbird.xml@ b3867c5

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since b3867c5 was 42ddc30, checked in by Xi Ruoyao <xry111@…>, 12 months ago

treewide: Replace "User Notes" with "Editor Notes"

  • Property mode set to 100644
File size: 16.0 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 "48d0bb152a73f4c62739b4eb7fe0eb3c">
10 <!ENTITY thunderbird-size "479 MB">
11 <!ENTITY thunderbird-buildsize "7.3 GB (205 MB installed)">
12 <!ENTITY thunderbird-time "20 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 Version 102.3.3: I disabled all but 4 cores. SBU was 20 (2019 seconds)
17 -->
18]>
19
20<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
21 <?dbhtml filename="thunderbird.html" ?>
22
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 &lfs113_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;-consolidated-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="autoconf213"/>,
90 <xref linkend="cbindgen"/>,
91 <xref linkend="dbus-glib"/>,
92 <xref linkend="gtk3"/>,
93 <!--and <xref linkend="gtk2"/>,-->
94 <xref linkend="llvm"/> including clang, <!-- used by default if found -->
95 <xref linkend="nodejs"/>,
96 <xref linkend="pulseaudio"/> (or <xref linkend="alsa-lib"/> if you edit
97 the mozconfig; although it is now deprecated by mozilla),
98 <xref linkend="python3"/> (rebuilt with the sqlite module),
99 <xref linkend="startup-notification"/>,
100 <xref linkend="zip"/>, and
101 <xref linkend="unzip"/>
102 <!--<xref linkend="yasm"/>-->
103 </para>
104
105 <bridgehead renderas="sect4">Recommended</bridgehead>
106 <para role="recommended">
107 <xref linkend="icu"/>,
108 <xref linkend="libevent"/>,
109 <xref linkend="libvpx"/>,
110 <xref linkend="nasm"/>,
111 <xref linkend="nspr"/>, and
112 <xref linkend="nss"/>
113 </para>
114
115 <note>
116 <para>
117 If you don't install recommended dependencies,
118 then internal copies of those packages will
119 be used. They might be tested to work, but
120 they can be out of date or contain security
121 holes.
122 </para>
123 </note>
124
125 <bridgehead renderas="sect4">Optional</bridgehead>
126 <para role="optional">
127 <!--<xref linkend="cyrus-sasl"/>,-->
128 <!--<xref linkend="doxygen"/>,-->
129 <!--<xref linkend="GConf"/>,-->
130 <xref linkend="wget"/>,
131 <xref linkend="wireless_tools"/>, and
132 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
133 </para>
134
135 <para condition="html" role="usernotes">
136 Editor Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
137 </para>
138 </sect2>
139
140 <sect2 role="installation">
141 <title>Installation of Thunderbird</title>
142
143 <note>
144 <para>
145 The build process for Thunderbird can use 8GB+ of RAM when linking.
146 Make sure that you have adequate swap or RAM before continuing.
147 </para>
148 </note>
149
150 <para>
151 The configuration of <application>Thunderbird</application> is
152 accomplished by creating a <filename>mozconfig</filename> file containing
153 the desired configuration options. A default
154 <filename>mozconfig</filename> is created below. To see the entire list
155 of available configuration options (and a brief description of each),
156 issue <command>./mach configure -- --help | less</command>. Create the file with
157 the following command:
158 </para>
159
160<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
161<literal># If you have a multicore machine, all cores will be used.
162
163# If you have installed wireless-tools comment out this line:
164ac_add_options --disable-necko-wifi
165
166# Uncomment the following option if you have not installed PulseAudio
167#ac_add_options --enable-audio-backends=alsa
168
169# Comment out following options if you have not installed
170# recommended dependencies:
171ac_add_options --with-system-libevent
172ac_add_options --with-system-libvpx
173ac_add_options --with-system-nspr
174ac_add_options --with-system-nss
175ac_add_options --with-system-icu
176
177# The elf-hack causes failed installs on some machines.
178# It is supposed to improve startup time and it shrinks libxul.so
179# by a few MB - comment this if you know your machine is not affected.
180ac_add_options --disable-elf-hack
181
182# The BLFS editors recommend not changing anything below this line:
183ac_add_options --prefix=/usr
184ac_add_options --enable-application=comm/mail
185
186ac_add_options --disable-crashreporter
187ac_add_options --disable-updater
188ac_add_options --disable-debug
189ac_add_options --disable-debug-symbols
190ac_add_options --disable-tests
191
192ac_add_options --enable-optimize=-O2
193ac_add_options --enable-linker=gold
194ac_add_options --enable-strip
195ac_add_options --enable-install-strip
196
197ac_add_options --enable-official-branding
198
199ac_add_options --enable-system-ffi
200ac_add_options --enable-system-pixman
201
202ac_add_options --with-system-jpeg
203ac_add_options --with-system-png
204ac_add_options --with-system-zlib
205
206# Using sandboxed wasm libraries has been moved to all builds instead
207# of only mozilla automation builds. It requires extra llvm packages
208# and was reported to seriously slow the build. Disable it.
209ac_add_options --without-wasm-sandboxed-libraries</literal>
210EOF</userinput></screen>
211<!-- Fixed in 102.9
212 <para>
213 A change in cbindgen-0.24.2 causes a symbol to now be output by
214 cbindgen, but it has already been defined in a header. This sed
215 prevents the build from eventually failing:
216 </para>
217
218<screen><userinput>sed -i '/ROOT_CLIP_CHAIN/d' gfx/webrender_bindings/webrender_ffi.h</userinput></screen>
219-->
220<!-- Not needed with clang
221 https://bugzilla.mozilla.org/show_bug.cgi?id=1729459
222 <para>
223 If building on a 32 bit machine, the following sed works around
224 an issue with an incompatible <quote>double</quote> type in one
225 header file:
226 </para>
227
228<screen><userinput>case "$(uname -m)" in
229 i?86) sed -e '/typedef[ ]*double/s/double/long double/' \
230 -i modules/fdlibm/src/math_private.h ;;
231esac</userinput></screen>
232-->
233
234 <para>
235 Fix building Thunderbird with Clang 16 or C++ headers from GCC 13.
236 And, work around a build failure with Rustc-1.70.0:
237 </para>
238
239<screen><userinput remap="pre">patch -Np1 -i ../thunderbird-&thunderbird-version;-consolidated-1.patch</userinput></screen>
240
241 <para>
242 Now invoke the Python <command>mach</command> script to compile
243 <application>Thunderbird</application>:
244 </para>
245
246 <note>
247 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
248 href="../../xincludes/mozshm.xml"/>
249
250 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
251 href="../../xincludes/mozmach.xml"/>
252
253 </note>
254 <!-- Fixed in 102.8
255 <para>
256 First remove an obsolete flag in python code, that has been removed
257 in python-3.11:
258 </para>
259
260<screen><userinput>grep -rl \"rU\" | xargs sed -i 's/"rU"/"r"/'</userinput></screen>
261
262 <para>
263 Then fix an issue with regular expressions in python-3.11:
264 </para>
265
266<screen><userinput>sed -e 's/?s)\./?s:.)/' \
267 -e '/?m)/{s/?m)/?m:/;s/\$"/$)"/}' \
268 -e '/?s)%/{s/?s)/?s:/;s/?"/?)"/}' \
269 -i xpcom/idl-parser/xpidl/xpidl.py</userinput></screen>
270-->
271
272<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none &amp;&amp;
273export MOZBUILD_STATE_PATH=./mozbuild &amp;&amp;
274./mach configure &amp;&amp;
275./mach build</userinput></screen>
276
277 <para>
278 This package does not come with a test suite.
279 </para>
280
281 <para>
282 Install <application>Thunderbird</application> by running the following
283 commands as the <systemitem class="username">root</systemitem> user:
284 </para>
285
286<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none ./mach install</userinput></screen>
287<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
288 <para>
289 Empty the environment variables which were set above:
290 </para>
291
292<screen><userinput>unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE MOZBUILD_STATE_PATH</userinput></screen>
293
294 </sect2>
295
296 <sect2 role="commands">
297 <title>Command Explanations</title>
298
299 <para>
300 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none</command>: Use the
301 system python to create a virtual environment for <command>mach</command>
302 without downloading any python wheels nor using the system python modules.
303 This prevent version mismatches between system modules and bundled ones.
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 <option><envar>CC=gcc CXX=g++</envar></option>: 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++. Building
331 with GCC on i?86 is currently broken.
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 Manager or Desktop Environment does not allow you to
343 configure a 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<!-- Bad URL
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.