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

12.2 gimp3 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since 6cbba3e4 was 99d85abd, checked in by Xi Ruoyao <xry111@…>, 4 months ago

firefox, thunderbird: Get rid of python-3.11

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