source: xsoft/other/thunderbird.xml@ 65f507b7

12.2 gimp3 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since 65f507b7 was 65f507b7, checked in by Douglas R. Reno <renodr@…>, 2 months ago

Update to Thunderbird-128.0esr (Security Update)

  • Property mode set to 100644
File size: 18.1 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
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;esr/source/thunderbird-&thunderbird-version;esr.source.tar.xz">
8 <!ENTITY thunderbird-download-ftp " ">
9 <!ENTITY thunderbird-md5sum "f20899eb706a94076ac88dfe97cc7a88">
10 <!ENTITY thunderbird-size "642 MB">
11 <!ENTITY thunderbird-buildsize "7.8 GB (256 MB installed)">
12 <!ENTITY thunderbird-time "16 SBU (on a 8-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;esr">
21 <?dbhtml filename="thunderbird.html" ?>
22
23
24 <title>Thunderbird-&thunderbird-version;esr</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 &lfs121_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
76 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="cbindgen"/>,
81 <xref linkend="dbus-glib"/>,
82 <xref linkend="gtk3"/>,
83 <xref linkend="llvm"/> including clang, <!-- used by default if found -->
84 <xref linkend="nodejs"/>,
85 <xref linkend="pulseaudio"/> (or <xref linkend="alsa-lib"/> if you edit
86 the mozconfig; although it is now deprecated by mozilla),
87 <xref linkend="python3"/> (rebuilt with the sqlite module),
88 <xref linkend="startup-notification"/>, and
89 <xref linkend="unzip"/>
90 <!--<xref linkend="yasm"/>-->
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <!-- When using system ICU, a problem occurs where the calendar and mail
96 functions do not render correctly and it causes other strange
97 behavior to occur. See Ticket #18323 for more details, as well as
98 https://lore.kernel.org/distributions/075a20b1-869b-78f3-9ace-e106a4d43ac4@linuxlounge.net/T/#u -->
99 <!--<xref linkend="icu"/>,-->
100 <xref linkend="libevent"/>,
101 <xref linkend="libvpx"/>,
102 <xref linkend="libwebp"/>,
103 <xref linkend="nasm"/>,
104 <xref linkend="nspr"/>, and
105 <xref linkend="nss"/>
106 </para>
107
108 <note>
109 <para>
110 If you don't install recommended dependencies,
111 then internal copies of those packages will
112 be used. They might be tested to work, but
113 they can be out of date or contain security
114 holes.
115 </para>
116 </note>
117
118 <bridgehead renderas="sect4">Optional</bridgehead>
119 <para role="optional">
120 <xref role="runtime" linkend="pciutils"/> (runtime),
121 <xref linkend="wget"/>,
122 <xref linkend="wireless_tools"/>, and
123 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
124 </para>
125
126 </sect2>
127
128 <sect2 role="installation">
129 <title>Installation of Thunderbird</title>
130
131 <note>
132 <para>
133 The build process for Thunderbird can use 8GB+ of RAM when linking.
134 Make sure that you have adequate swap or RAM before continuing.
135 </para>
136 </note>
137
138 <!-- Restore after Python 3.12 is usable for this package again
139 <para>
140 The building system ships several internal copies of the Python 3
141 modules <application>setuptools</application> and
142 <filename>six.py</filename>. The shipped copies are too old
143 to work well with Python 3.12 or later. Replace them with the
144 symlinks to the LFS <application>setuptools</application> package and
145 <xref linkend='six'/> already installed on the system, and adapt the
146 building system for these updated Python modules. We also need to
147 rewrite the code based on the <filename>imp</filename> module removed
148 in Python 3.12 and later using the <filename>importlib</filename>
149 module:
150 </para>
151
152<screen><userinput>(for i in $(find -name six.py); do
153 ln -sfv /usr/lib/python&python3-majorver;/site-packages/six.py $i
154 [ $? = 0 ] || exit $?
155 done) &amp;&amp;
156
157sed '/ConfigParser/s/Safe//' \
158 -i testing/mozbase/mozprofile/mozprofile/prefs.py &amp;&amp;
159
160(for i in setuptools distutils-precedence.pth \
161 pkg_resources _distutils_hack; do
162 rm -rf third_party/python/setuptools/$i &amp;&amp;
163 ln -sv /usr/lib/python&python3-majorver;/site-packages/$i \
164 third_party/python/setuptools
165 [ $? = 0 ] || exit $?
166 done) &amp;&amp;
167
168sed 's/distutils/setuptools._&amp;/' \
169 -i python/mozbuild/mozbuild/nodeutil.py &amp;&amp;
170
171sed -e '/^import/s/imp$/importlib.util/' \
172 -e 's/imp.new_module/__import__/' \
173 -e "s/imp.load_source\(.*\)/spec = \
174 importlib.util.spec_from_file_location\1; \
175 mod = importlib.util.module_from_spec(spec); \
176 spec.loader.exec_module(mod)/" -i python/mach/mach/main.py &amp;&amp;
177sed '/import imp/d' -i netwerk/dns/prepare_tlds.py
178</userinput></screen>
179-->
180
181 <para>
182 The configuration of <application>Thunderbird</application> is
183 accomplished by creating a <filename>mozconfig</filename> file containing
184 the desired configuration options. A default
185 <filename>mozconfig</filename> is created below. To see the entire list
186 of available configuration options (and a brief description of each),
187 issue <command>./mach configure -- --help | less</command>. Create the file with
188 the following command:
189 </para>
190
191<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
192<literal># If you have a multicore machine, all cores will be used.
193
194# If you have installed wireless-tools comment out this line:
195ac_add_options --disable-necko-wifi
196
197# Uncomment the following option if you have not installed PulseAudio
198#ac_add_options --enable-audio-backends=alsa
199
200# Comment out following options if you have not installed
201# recommended dependencies:
202ac_add_options --with-system-libevent
203ac_add_options --with-system-libvpx
204ac_add_options --with-system-nspr
205ac_add_options --with-system-nss
206ac_add_options --with-system-webp
207<!-- With Thunderbird ESR 128 we'd replace the following part with
208"- -enable-elf-hack=relr", or remove it if relr becomes the default. -->
209# on some machines. It is supposed to improve startup time and it shrinks
210# libxul.so by a few MB. With recent Binutils releases the linker already
211# supports a much safer and generic way for this.
212ac_add_options --disable-elf-hack
213export LDFLAGS="$LDFLAGS -Wl,-z,pack-relative-relocs"
214
215# The BLFS editors recommend not changing anything below this line:
216ac_add_options --prefix=/usr
217ac_add_options --enable-application=comm/mail
218
219ac_add_options --disable-crashreporter
220ac_add_options --disable-updater
221ac_add_options --disable-debug
222ac_add_options --disable-debug-symbols
223ac_add_options --disable-tests
224
225# The SIMD code relies on the unmaintained packed_simd crate which
226# fails to build with Rustc >= 1.78.0. We may re-enable it once
227# Mozilla port the code to use std::simd and std::simd is stabilized.
228ac_add_options --disable-rust-simd
229
230ac_add_options --enable-strip
231ac_add_options --enable-install-strip
232
233# You cannot distribute the binary if you do this.
234ac_add_options --enable-official-branding
235
236ac_add_options --enable-system-ffi
237ac_add_options --enable-system-pixman
238
239ac_add_options --with-system-jpeg
240ac_add_options --with-system-png
241ac_add_options --with-system-zlib
242
243# Using sandboxed wasm libraries has been moved to all builds instead
244# of only mozilla automation builds. It requires extra llvm packages
245# and was reported to seriously slow the build. Disable it.
246ac_add_options --without-wasm-sandboxed-libraries</literal>
247EOF</userinput></screen>
248
249 <!-- https://github.com/rust-lang/rust-bindgen/pull/2689 -->
250<!--
251 <para>
252 Adapt the shipped <application>rust-bindgen</application> copy for
253 LLVM-18 and later, and tell <command>cargo</command> we've modified
254 the code of <application>rust-bindgen</application> so the checksum
255 verification of this crate should be skipped:
256 </para>
257
258 <screen><userinput>sed -e "/match cursor.kind()/a \
259 CXCursor_LinkageSpec => return Err(ParseError::Recurse)," \
260 -i third_party/rust/bindgen/ir/item.rs &amp;&amp;
261
262cat &gt;&gt; Cargo.toml &lt;&lt; EOF &amp;&amp;
263<literal>[patch.crates-io.bindgen_0_64_0]
264package = "bindgen"
265version = "0.64.0"
266path = "third_party/rust/bindgen"</literal>
267EOF
268
269sed -r '/name = "bindgen"/,+5 s/^source|^checksum/#&amp;/' \
270 -i Cargo.lock</userinput></screen>
271-->
272
273 <!-- https://hg.mozilla.org/mozilla-central/rev/ba6abbd36b49 -->
274<!--
275 <para>
276 Adapt the WebRTC code to use 64-bit timestamp to fix a build
277 failure with Clang-18 and later:
278 </para>
279
280 <screen><userinput>sed 's/uint32_t timestamp/uint64_t timestamp/' \
281 -i dom/media/gmp-plugin-openh264/gmp-fake-openh264.cpp \
282 dom/media/gtest/TestGMPRemoveAndDelete.cpp \
283 dom/media/webrtc/libwebrtcglue/WebrtcGmpVideoCodec.cpp &amp;&amp;
284
285sed '/mInputImageMap/s/uint32_t/uint64_t/' \
286 -i dom/media/webrtc/libwebrtcglue/WebrtcGmpVideoCodec.h</userinput></screen>
287
288 <para>
289 Remove several lines of Rust code only useful for ARM and failing to
290 compile with Rustc-1.78.0 or newer:
291 </para>
292
293 <screen><userinput>sed '/cfg_attr/,/)]/d' -i gfx/qcms/src/lib.rs</userinput></screen>
294-->
295
296 <para>
297 Now invoke the Python <command>mach</command> script to compile
298 <application>Thunderbird</application>:
299 </para>
300
301 <note>
302 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
303 href="../../xincludes/mozshm.xml"/>
304 </note>
305
306<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none &amp;&amp;
307export MOZBUILD_STATE_PATH=$(pwd)/mozbuild &amp;&amp;
308./mach build</userinput></screen>
309
310 <para>
311 This package does not come with a test suite.
312 </para>
313
314 <para>
315 Install <application>Thunderbird</application> by running the following
316 commands as the <systemitem class="username">root</systemitem> user:
317 </para>
318
319<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none ./mach install</userinput></screen>
320<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
321
322 <para>
323 Empty the environment variables which were set above:
324 </para>
325
326<screen><userinput>unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE &amp;&amp;
327unset MOZBUILD_STATE_PATH</userinput></screen>
328
329 </sect2>
330
331 <sect2 role="commands">
332 <title>Command Explanations</title>
333
334 <para>
335 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none</command>: Use the
336 system python to create a virtual environment for <command>mach</command>
337 without downloading any python wheels nor using the system python modules.
338 This prevent version mismatches between system modules and bundled ones.
339 </para>
340
341<!--
342 <para>
343 <command>./mach configure</command>: This validates the supplied
344 dependencies and the <filename>mozconfig</filename>.
345 </para>
346-->
347
348 <para>
349 <option>./mach build --verbose</option>: Use this alternative if you
350 need details of which files are being compiled, together with any C or
351 C++ flags being used.
352 </para>
353
354 <para>
355 <option>./mach build -jN</option>: The build should, by default, use
356 all the online CPU cores. If using all the cores causes the build to swap
357 because you have insufficient memory, using fewer cores can be faster.
358 </para>
359
360 <para>
361 <option><envar>CC=gcc CXX=g++</envar></option>: BLFS used to
362 prefer to use gcc and g++ instead of upstream's defaults of the
363 <application>clang</application> programs. With the release of
364 gcc-12 the build takes longer with gcc and g++, primarily because
365 of extra warnings, and is bigger. Set these environment variables
366 <emphasis>before you run the configure script</emphasis>
367 if you wish to continue to use gcc, g++. Building
368 with GCC on i?86 is currently broken.
369 </para>
370
371 </sect2>
372
373 <sect2 role="configuration">
374 <title>Configuring Thunderbird</title>
375
376 <sect3><title>Configuration Information</title>
377
378 <para>
379 If your Window Manager or Desktop Environment does not allow you to
380 configure a default browser, you can add a configuration parameter to
381 <application>Thunderbird</application> so that a browser will start when
382 you click on an Internet/intranet/local URL. The procedure to check
383 or modify any of the configuration parameters is quite simple and the
384 instructions here can be used to view or modify any of the parameters.
385 </para>
386
387 <para>
388 First, open the configuration dialog by opening the <quote>Edit</quote>
389 drop-down menu. Choose <quote>Settings</quote> and then scroll down
390 to the bottom of the page. Then, click the <quote>Config Editor</quote>
391 button. Click on the <quote>I accept the risk!</quote> button.
392 This will display a list of the configuration preferences and
393 information related to each one. You can use the <quote>Filter:</quote>
394 bar to enter search criteria and narrow down the listed items. Changing
395 a preference can be done using two methods. One, if the preference has a
396 boolean value (True/False), simply double-click on the preference to
397 toggle the value and two, for other preferences simply right-click on
398 the desired line, choose <quote>Modify</quote> from the menu and change
399 the value. Creating new preference items is accomplished in the same
400 way, except choose <quote>New</quote> from the menu and provide the
401 desired data into the fields when prompted.
402 </para>
403
404 <!-- Doesn't seem to be present anymore in 128.0
405 <para>
406 The configuration preference item you need to check so that
407 <application>Thunderbird</application> uses a specified browser is the
408 <parameter>network.protocol-handler.app.http</parameter> which should be
409 set to the path of the desired browser, e.g.
410 <option>/usr/bin/firefox</option>.
411 </para>
412-->
413<!-- Bad URL
414 <tip>
415 <para>
416 There is a multitude of configuration parameters you can tweak to
417 customize <application>Thunderbird</application>. A very extensive,
418 but not so up-to-date list of these parameters can be found at
419 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
420 </para>
421 </tip>
422-->
423 <para>
424
425 If you use a desktop environment such as <application>GNOME</application>
426 or <application>KDE</application>, a desktop file
427 <filename>thunderbird.desktop</filename> may be created, in order to
428 include a <quote><application>Thunderbird</application></quote> entry in
429 the menu. <!--If you didn't enable
430 <application>startup-notification</application> in your mozconfig, then
431 change the StartupNotify line to false.--> Run the following commands as the
432 <systemitem class="username">root</systemitem> user:
433
434 </para>
435
436<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
437
438cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
439<literal>[Desktop Entry]
440Name=Thunderbird Mail
441Comment=Send and receive mail with Thunderbird
442GenericName=Mail Client
443Exec=thunderbird %u
444Terminal=false
445Type=Application
446Icon=thunderbird
447Categories=Network;Email;
448MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
449StartupNotify=true</literal>
450EOF
451
452ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
453 /usr/share/pixmaps/thunderbird.png</userinput></screen>
454 </sect3>
455 </sect2>
456
457 <sect2 role="content">
458 <title>Contents</title>
459
460 <segmentedlist>
461 <segtitle>Installed Program</segtitle>
462 <segtitle>Installed Libraries</segtitle>
463 <segtitle>Installed Directory</segtitle>
464
465 <seglistitem>
466 <seg>
467 thunderbird
468 </seg>
469 <seg>
470 Numerous libraries and modules in the /usr/lib/thunderbird directory
471 </seg>
472 <seg>
473 /usr/lib/thunderbird
474 </seg>
475 </seglistitem>
476 </segmentedlist>
477
478 <variablelist>
479 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
480 <?dbfo list-presentation="list"?>
481 <?dbhtml list-presentation="table"?>
482
483 <varlistentry id="thunderbird-prog">
484 <term><command>thunderbird</command></term>
485 <listitem>
486 <para>
487 is <application>Mozilla</application>'s email and newsgroup client
488 </para>
489 <indexterm zone="thunderbird thunderbird-prog">
490 <primary sortas="b-thunderbird">thunderbird</primary>
491 </indexterm>
492 </listitem>
493 </varlistentry>
494
495 </variablelist>
496
497 </sect2>
498
499</sect1>
Note: See TracBrowser for help on using the repository browser.