source: xsoft/other/thunderbird.xml@ bc35d57

12.1 12.2 gimp3 ken/TL2024 lazarus plabs/newcss rahul/power-profiles-daemon trunk xry111/for-12.3 xry111/llvm18 xry111/spidermonkey128
Last change on this file since bc35d57 was 1859ee6, checked in by Pierre Labastie <pierre.labastie@…>, 9 months ago

Remove links to deleted wiki pages

See https://wiki.linuxfromscratch.org/blfs/ticket/18952

  • Property mode set to 100644
File size: 16.2 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 "f4bdb62a3dabdba41296f875a1e86ac0">
10 <!ENTITY thunderbird-size "508 MB">
11 <!ENTITY thunderbird-buildsize "6.4 GB (236 MB installed)">
12 <!ENTITY thunderbird-time "17 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 &lfs120_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="six"/>,
89 <xref linkend="startup-notification"/>, and
90 <xref linkend="unzip"/>
91 <!--<xref linkend="yasm"/>-->
92 </para>
93
94 <bridgehead renderas="sect4">Recommended</bridgehead>
95 <para role="recommended">
96 <!-- When using system ICU, a problem occurs where the calendar and mail
97 functions do not render correctly and it causes other strange
98 behavior to occur. See Ticket #18323 for more details, as well as
99 https://lore.kernel.org/distributions/075a20b1-869b-78f3-9ace-e106a4d43ac4@linuxlounge.net/T/#u -->
100 <!--<xref linkend="icu"/>,-->
101 <xref linkend="libevent"/>,
102 <xref linkend="libvpx"/>,
103 <xref linkend="libwebp"/>,
104 <xref linkend="nasm"/>,
105 <xref linkend="nspr"/>, and
106 <xref linkend="nss"/>
107 </para>
108
109 <note>
110 <para>
111 If you don't install recommended dependencies,
112 then internal copies of those packages will
113 be used. They might be tested to work, but
114 they can be out of date or contain security
115 holes.
116 </para>
117 </note>
118
119 <bridgehead renderas="sect4">Optional</bridgehead>
120 <para role="optional">
121 <xref role="runtime" linkend="pciutils"/> (runtime),
122 <xref linkend="wget"/>,
123 <xref linkend="wireless_tools"/>, and
124 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
125 </para>
126
127 </sect2>
128
129 <sect2 role="installation">
130 <title>Installation of Thunderbird</title>
131
132 <note>
133 <para>
134 The build process for Thunderbird can use 8GB+ of RAM when linking.
135 Make sure that you have adequate swap or RAM before continuing.
136 </para>
137 </note>
138
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 <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# This enables SIMD optimization in the shipped encoding_rs crate.
225ac_add_options --enable-rust-simd
226
227ac_add_options --enable-strip
228ac_add_options --enable-install-strip
229
230# You cannot distribute the binary if you do this.
231ac_add_options --enable-official-branding
232
233ac_add_options --enable-system-ffi
234ac_add_options --enable-system-pixman
235
236ac_add_options --with-system-jpeg
237ac_add_options --with-system-png
238ac_add_options --with-system-zlib
239
240# Using sandboxed wasm libraries has been moved to all builds instead
241# of only mozilla automation builds. It requires extra llvm packages
242# and was reported to seriously slow the build. Disable it.
243ac_add_options --without-wasm-sandboxed-libraries</literal>
244EOF</userinput></screen>
245
246 <para>
247 Now invoke the Python <command>mach</command> script to compile
248 <application>Thunderbird</application>:
249 </para>
250
251 <note>
252 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
253 href="../../xincludes/mozshm.xml"/>
254 </note>
255
256<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none &amp;&amp;
257export MOZBUILD_STATE_PATH=./mozbuild &amp;&amp;
258./mach configure &amp;&amp;
259./mach build</userinput></screen>
260
261 <para>
262 This package does not come with a test suite.
263 </para>
264
265 <para>
266 Install <application>Thunderbird</application> by running the following
267 commands as the <systemitem class="username">root</systemitem> user:
268 </para>
269
270<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none ./mach install</userinput></screen>
271<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
272 <para>
273 Empty the environment variables which were set above:
274 </para>
275
276<screen><userinput>unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE MOZBUILD_STATE_PATH</userinput></screen>
277
278 </sect2>
279
280 <sect2 role="commands">
281 <title>Command Explanations</title>
282
283 <para>
284 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none</command>: Use the
285 system python to create a virtual environment for <command>mach</command>
286 without downloading any python wheels nor using the system python modules.
287 This prevent version mismatches between system modules and bundled ones.
288 </para>
289
290 <para>
291 <command>./mach configure</command>: This validates the supplied
292 dependencies and the <filename>mozconfig</filename>.
293 </para>
294
295 <para>
296 <option>./mach build --verbose</option>: Use this alternative if you
297 need details of which files are being compiled, together with any C or
298 C++ flags being used.
299 </para>
300
301 <para>
302 <option>./mach build -jN</option>: The build should, by default, use
303 all the online CPU cores. If using all the cores causes the build to swap
304 because you have insufficient memory, using fewer cores can be faster.
305 </para>
306
307 <para>
308 <option><envar>CC=gcc CXX=g++</envar></option>: BLFS used to
309 prefer to use gcc and g++ instead of upstream's defaults of the
310 <application>clang</application> programs. With the release of
311 gcc-12 the build takes longer with gcc and g++, primarily because
312 of extra warnings, and is bigger. Set these environment variables
313 <emphasis>before you run the configure script</emphasis>
314 if you wish to continue to use gcc, g++. Building
315 with GCC on i?86 is currently broken.
316 </para>
317
318 </sect2>
319
320 <sect2 role="configuration">
321 <title>Configuring Thunderbird</title>
322
323 <sect3><title>Configuration Information</title>
324
325 <para>
326 If your Window Manager or Desktop Environment does not allow you to
327 configure a default browser, you can add a configuration parameter to
328 <application>Thunderbird</application> so that a browser will start when
329 you click on an Internet/intranet/local URL. The procedure to check
330 or modify any of the configuration parameters is quite simple and the
331 instructions here can be used to view or modify any of the parameters.
332 </para>
333
334 <para>
335 First, open the configuration dialog by opening the <quote>Edit</quote>
336 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
337 to the bottom of the page. Then, click the <quote>Config Editor</quote>
338 button. Click on the <quote>I accept the risk!</quote> button.
339 This will display a list of the configuration preferences and
340 information related to each one. You can use the <quote>Filter:</quote>
341 bar to enter search criteria and narrow down the listed items. Changing
342 a preference can be done using two methods. One, if the preference has a
343 boolean value (True/False), simply double-click on the preference to
344 toggle the value and two, for other preferences simply right-click on
345 the desired line, choose <quote>Modify</quote> from the menu and change
346 the value. Creating new preference items is accomplished in the same
347 way, except choose <quote>New</quote> from the menu and provide the
348 desired data into the fields when prompted.
349 </para>
350
351 <para>
352 The configuration preference item you need to check so that
353 <application>Thunderbird</application> uses a specified browser is the
354 <parameter>network.protocol-handler.app.http</parameter> which should be
355 set to the path of the desired browser, e.g.
356 <option>/usr/bin/firefox</option>.
357 </para>
358<!-- Bad URL
359 <tip>
360 <para>
361 There is a multitude of configuration parameters you can tweak to
362 customize <application>Thunderbird</application>. A very extensive,
363 but not so up-to-date list of these parameters can be found at
364 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
365 </para>
366 </tip>
367-->
368 <para>
369
370 If you use a desktop environment such as <application>GNOME</application>
371 or <application>KDE</application>, a desktop file
372 <filename>thunderbird.desktop</filename> may be created, in order to
373 include a <quote><application>Thunderbird</application></quote> entry in
374 the menu. <!--If you didn't enable
375 <application>startup-notification</application> in your mozconfig, then
376 change the StartupNotify line to false.--> Run the following commands as the
377 <systemitem class="username">root</systemitem> user:
378
379 </para>
380
381<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
382
383cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
384<literal>[Desktop Entry]
385Name=Thunderbird Mail
386Comment=Send and receive mail with Thunderbird
387GenericName=Mail Client
388Exec=thunderbird %u
389Terminal=false
390Type=Application
391Icon=thunderbird
392Categories=Network;Email;
393MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
394StartupNotify=true</literal>
395EOF
396
397ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
398 /usr/share/pixmaps/thunderbird.png</userinput></screen>
399 </sect3>
400 </sect2>
401
402 <sect2 role="content">
403 <title>Contents</title>
404
405 <segmentedlist>
406 <segtitle>Installed Program</segtitle>
407 <segtitle>Installed Libraries</segtitle>
408 <segtitle>Installed Directory</segtitle>
409
410 <seglistitem>
411 <seg>
412 thunderbird
413 </seg>
414 <seg>
415 Numerous libraries and modules in the /usr/lib/thunderbird directory
416 </seg>
417 <seg>
418 /usr/lib/thunderbird
419 </seg>
420 </seglistitem>
421 </segmentedlist>
422
423 <variablelist>
424 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
425 <?dbfo list-presentation="list"?>
426 <?dbhtml list-presentation="table"?>
427
428 <varlistentry id="thunderbird-prog">
429 <term><command>thunderbird</command></term>
430 <listitem>
431 <para>
432 is <application>Mozilla</application>'s email and newsgroup client
433 </para>
434 <indexterm zone="thunderbird thunderbird-prog">
435 <primary sortas="b-thunderbird">thunderbird</primary>
436 </indexterm>
437 </listitem>
438 </varlistentry>
439
440 </variablelist>
441
442 </sect2>
443
444</sect1>
Note: See TracBrowser for help on using the repository browser.