source: xsoft/other/thunderbird.xml@ 42c1a527

trunk
Last change on this file since 42c1a527 was debbb3bf, checked in by Douglas R. Reno <renodr@…>, 2 weeks ago

Update to thunderbird-128.2.0

  • Property mode set to 100644
File size: 16.2 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 "88a51261eb7f11cc66935c2eb7ae4e63">
10 <!ENTITY thunderbird-size "644 MB">
11 <!ENTITY thunderbird-buildsize "7.9 GB (255 MB installed)">
12 <!ENTITY thunderbird-time "14 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 &lfs122_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="gtk3"/>,
82 <xref linkend="llvm"/> including clang, <!-- used by default if found -->
83 <xref linkend="nodejs"/>,
84 <xref linkend="pulseaudio"/> (or <xref linkend="alsa-lib"/> if you edit
85 the mozconfig; although it is now deprecated by mozilla),
86 <xref linkend="python3"/> (rebuilt with the sqlite module),
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 8 GB or more of RAM when
133 linking. Make sure that you have adequate swap or RAM before
134 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
208# The BLFS editors recommend not changing anything below this line:
209ac_add_options --prefix=/usr
210ac_add_options --enable-application=comm/mail
211
212ac_add_options --disable-crashreporter
213ac_add_options --disable-updater
214ac_add_options --disable-debug
215ac_add_options --disable-debug-symbols
216ac_add_options --disable-tests
217
218# This enables SIMD optimization in the shipped encoding_rs crate.
219ac_add_options --enable-rust-simd
220
221ac_add_options --enable-strip
222ac_add_options --enable-install-strip
223
224# You cannot distribute the binary if you do this.
225ac_add_options --enable-official-branding
226
227ac_add_options --enable-system-ffi
228ac_add_options --enable-system-pixman
229
230ac_add_options --with-system-jpeg
231ac_add_options --with-system-png
232ac_add_options --with-system-zlib
233
234# Using sandboxed wasm libraries has been moved to all builds instead
235# of only mozilla automation builds. It requires extra llvm packages
236# and was reported to seriously slow the build. Disable it.
237ac_add_options --without-wasm-sandboxed-libraries</literal>
238EOF</userinput></screen>
239
240 <!-- https://phabricator.services.mozilla.com/D219025 -->
241<!--
242 <para>
243 Adapt two files for compatibility with cbindgen-0.27.0 or later:
244 </para>
245
246 <screen><userinput>sed 's/input.try/&amp;_parse/' \
247 -i servo/components/style_traits/values.rs &amp;&amp;
248sed '0,/"Keyframe"/{//d}' -i servo/ports/geckolib/cbindgen.toml</userinput></screen>
249-->
250
251 <para>
252 Now invoke the Python <command>mach</command> script to compile
253 <application>Thunderbird</application>:
254 </para>
255
256 <note>
257 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
258 href="../../xincludes/mozshm.xml"/>
259 </note>
260
261<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none &amp;&amp;
262export MOZBUILD_STATE_PATH=$(pwd)/mozbuild &amp;&amp;
263./mach build</userinput></screen>
264
265 <para>
266 This package does not come with a test suite.
267 </para>
268
269 <para>
270 Install <application>Thunderbird</application> by running the following
271 commands as the <systemitem class="username">root</systemitem> user:
272 </para>
273
274<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none ./mach install</userinput></screen>
275<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
276
277 <para>
278 Empty the environment variables which were set above:
279 </para>
280
281<screen><userinput>unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE &amp;&amp;
282unset MOZBUILD_STATE_PATH</userinput></screen>
283
284 </sect2>
285
286 <sect2 role="commands">
287 <title>Command Explanations</title>
288
289 <para>
290 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none</command>: Use the
291 system python to create a virtual environment for <command>mach</command>
292 without downloading any python wheels nor using the system python modules.
293 This prevent version mismatches between system modules and bundled ones.
294 </para>
295
296<!--
297 <para>
298 <command>./mach configure</command>: This validates the supplied
299 dependencies and the <filename>mozconfig</filename>.
300 </para>
301-->
302
303 <para>
304 <option>./mach build --verbose</option>: Use this alternative if you
305 need details of which files are being compiled, together with any C or
306 C++ flags being used.
307 </para>
308
309 <para>
310 <option>./mach build -jN</option>: The build should, by default, use
311 all the online CPU cores. If using all the cores causes the build to swap
312 because you have insufficient memory, using fewer cores can be faster.
313 </para>
314
315 <para>
316 <option><envar>CC=gcc CXX=g++</envar></option>: BLFS used to
317 prefer to use gcc and g++ instead of upstream's defaults of the
318 <application>clang</application> programs. With the release of
319 gcc-12 the build takes longer with gcc and g++, primarily because
320 of extra warnings, and is bigger. Set these environment variables
321 <emphasis>before you run the configure script</emphasis>
322 if you wish to continue to use gcc, g++. Building
323 with GCC on i?86 is currently broken.
324 </para>
325
326 </sect2>
327
328 <sect2 role="configuration">
329 <title>Configuring Thunderbird</title>
330
331 <sect3><title>Configuration Information</title>
332
333 <para>
334 If your Window Manager or Desktop Environment does not allow you to
335 configure a default browser, you can add a configuration parameter to
336 <application>Thunderbird</application> so that a browser will start when
337 you click on an Internet/intranet/local URL. The procedure to check
338 or modify any of the configuration parameters is quite simple and the
339 instructions here can be used to view or modify any of the parameters.
340 </para>
341
342 <para>
343 First, open the configuration dialog by opening the <quote>Edit</quote>
344 drop-down menu. Choose <quote>Settings</quote> and then scroll down
345 to the bottom of the page. Then, click the <quote>Config Editor</quote>
346 button. Click on the <quote>I accept the risk!</quote> button.
347 This will display a list of the configuration preferences and
348 information related to each one. You can use the <quote>Filter:</quote>
349 bar to enter search criteria and narrow down the listed items. Changing
350 a preference can be done using two methods. One, if the preference has a
351 boolean value (True/False), simply double-click on the preference to
352 toggle the value and two, for other preferences simply right-click on
353 the desired line, choose <quote>Modify</quote> from the menu and change
354 the value. Creating new preference items is accomplished in the same
355 way, except choose <quote>New</quote> from the menu and provide the
356 desired data into the fields when prompted.
357 </para>
358
359 <!-- Doesn't seem to be present anymore in 128.0
360 <para>
361 The configuration preference item you need to check so that
362 <application>Thunderbird</application> uses a specified browser is the
363 <parameter>network.protocol-handler.app.http</parameter> which should be
364 set to the path of the desired browser, e.g.
365 <option>/usr/bin/firefox</option>.
366 </para>
367-->
368<!-- Bad URL
369 <tip>
370 <para>
371 There is a multitude of configuration parameters you can tweak to
372 customize <application>Thunderbird</application>. A very extensive,
373 but not so up-to-date list of these parameters can be found at
374 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
375 </para>
376 </tip>
377-->
378 <para>
379
380 If you use a desktop environment such as <application>GNOME</application>
381 or <application>KDE</application>, a desktop file
382 <filename>thunderbird.desktop</filename> may be created, in order to
383 include a <quote><application>Thunderbird</application></quote> entry in
384 the menu. <!--If you didn't enable
385 <application>startup-notification</application> in your mozconfig, then
386 change the StartupNotify line to false.--> Run the following commands as the
387 <systemitem class="username">root</systemitem> user:
388
389 </para>
390
391<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
392
393cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
394<literal>[Desktop Entry]
395Name=Thunderbird Mail
396Comment=Send and receive mail with Thunderbird
397GenericName=Mail Client
398Exec=thunderbird %u
399Terminal=false
400Type=Application
401Icon=thunderbird
402Categories=Network;Email;
403MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
404StartupNotify=true</literal>
405EOF
406
407ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
408 /usr/share/pixmaps/thunderbird.png</userinput></screen>
409 </sect3>
410 </sect2>
411
412 <sect2 role="content">
413 <title>Contents</title>
414
415 <segmentedlist>
416 <segtitle>Installed Program</segtitle>
417 <segtitle>Installed Libraries</segtitle>
418 <segtitle>Installed Directory</segtitle>
419
420 <seglistitem>
421 <seg>
422 thunderbird
423 </seg>
424 <seg>
425 Numerous libraries and modules in the /usr/lib/thunderbird directory
426 </seg>
427 <seg>
428 /usr/lib/thunderbird
429 </seg>
430 </seglistitem>
431 </segmentedlist>
432
433 <variablelist>
434 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
435 <?dbfo list-presentation="list"?>
436 <?dbhtml list-presentation="table"?>
437
438 <varlistentry id="thunderbird-prog">
439 <term><command>thunderbird</command></term>
440 <listitem>
441 <para>
442 is <application>Mozilla</application>'s email and newsgroup client
443 </para>
444 <indexterm zone="thunderbird thunderbird-prog">
445 <primary sortas="b-thunderbird">thunderbird</primary>
446 </indexterm>
447 </listitem>
448 </varlistentry>
449
450 </variablelist>
451
452 </sect2>
453
454</sect1>
Note: See TracBrowser for help on using the repository browser.