source: xsoft/other/thunderbird.xml@ f5c9139

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since f5c9139 was 8a742802, checked in by Douglas R. Reno <renodr@…>, 15 months ago

Typo fix from rhubarbpieguy

  • Property mode set to 100644
File size: 15.9 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 "90bd924a40d66b4e708a47b8594ae41e">
10 <!ENTITY thunderbird-size "480 MB">
11 <!ENTITY thunderbird-buildsize "7.4 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;-upstream_fixes-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 User 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>mozilla/configure --help</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 rustc-1.68.x:
236 </para>
237
238<screen><userinput remap="pre">patch -Np1 -i ../thunderbird-&thunderbird-version;-upstream_fixes-1.patch</userinput></screen>
239
240 <para>
241 Now invoke the Python <command>mach</command> script to compile
242 <application>Thunderbird</application>:
243 </para>
244
245 <note>
246 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
247 href="../../xincludes/mozshm.xml"/>
248
249 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
250 href="../../xincludes/mozmach.xml"/>
251
252 </note>
253 <!-- Fixed in 102.8
254 <para>
255 First remove an obsolete flag in python code, that has been removed
256 in python-3.11:
257 </para>
258
259<screen><userinput>grep -rl \"rU\" | xargs sed -i 's/"rU"/"r"/'</userinput></screen>
260
261 <para>
262 Then fix an issue with regular expressions in python-3.11:
263 </para>
264
265<screen><userinput>sed -e 's/?s)\./?s:.)/' \
266 -e '/?m)/{s/?m)/?m:/;s/\$"/$)"/}' \
267 -e '/?s)%/{s/?s)/?s:/;s/?"/?)"/}' \
268 -i xpcom/idl-parser/xpidl/xpidl.py</userinput></screen>
269-->
270
271<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none &amp;&amp;
272export MOZBUILD_STATE_PATH=./mozbuild &amp;&amp;
273./mach configure &amp;&amp;
274./mach build</userinput></screen>
275
276 <para>
277 This package does not come with a test suite.
278 </para>
279
280 <para>
281 Install <application>Thunderbird</application> by running the following
282 commands as the <systemitem class="username">root</systemitem> user:
283 </para>
284
285<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none ./mach install</userinput></screen>
286<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
287 <para>
288 Empty the environment variables which were set above:
289 </para>
290
291<screen><userinput>unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE MOZBUILD_STATE_PATH</userinput></screen>
292
293 </sect2>
294
295 <sect2 role="commands">
296 <title>Command Explanations</title>
297
298 <para>
299 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none</command>: Use the
300 system python to create a virtual environment for <command>mach</command>
301 without downloading any python wheels nor using the system python modules.
302 This prevent version mismatches between system modules and bundled ones.
303 </para>
304
305 <para>
306 <command>./mach configure</command>: This validates the supplied
307 dependencies and the <filename>mozconfig</filename>.
308 </para>
309
310 <para>
311 <option>./mach build --verbose</option>: Use this alternative if you
312 need details of which files are being compiled, together with any C or
313 C++ flags being used.
314 </para>
315
316 <para>
317 <option>./mach build -jN</option>: The build should, by default, use
318 all the online CPU cores. If using all the cores causes the build to swap
319 because you have insufficient memory, using fewer cores can be faster.
320 </para>
321
322 <para>
323 <option><envar>CC=gcc CXX=g++</envar></option>: BLFS used to
324 prefer to use gcc and g++ instead of upstream's defaults of the
325 <application>clang</application> programs. With the release of
326 gcc-12 the build takes longer with gcc and g++, primarily because
327 of extra warnings, and is bigger. Set these environment variables
328 <emphasis>before you run the configure script</emphasis>
329 if you wish to continue to use gcc, g++. Building
330 with GCC on i?86 is currently broken.
331 </para>
332
333 </sect2>
334
335 <sect2 role="configuration">
336 <title>Configuring Thunderbird</title>
337
338 <sect3><title>Configuration Information</title>
339
340 <para>
341 If your Window Manager or Desktop Environment does not allow you to
342 configure a default browser, you can add a configuration parameter to
343 <application>Thunderbird</application> so that a browser will start when
344 you click on an Internet/intranet/local URL. The procedure to check
345 or modify any of the configuration parameters is quite simple and the
346 instructions here can be used to view or modify any of the parameters.
347 </para>
348
349 <para>
350 First, open the configuration dialog by opening the <quote>Edit</quote>
351 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
352 to the bottom of the page. Then, click the <quote>Config Editor</quote>
353 button. Click on the <quote>I accept the risk!</quote> button.
354 This will display a list of the configuration preferences and
355 information related to each one. You can use the <quote>Filter:</quote>
356 bar to enter search criteria and narrow down the listed items. Changing
357 a preference can be done using two methods. One, if the preference has a
358 boolean value (True/False), simply double-click on the preference to
359 toggle the value and two, for other preferences simply right-click on
360 the desired line, choose <quote>Modify</quote> from the menu and change
361 the value. Creating new preference items is accomplished in the same
362 way, except choose <quote>New</quote> from the menu and provide the
363 desired data into the fields when prompted.
364 </para>
365
366 <para>
367 The configuration preference item you need to check so that
368 <application>Thunderbird</application> uses a specified browser is the
369 <parameter>network.protocol-handler.app.http</parameter> which should be
370 set to the path of the desired browser, e.g.
371 <option>/usr/bin/firefox</option>.
372 </para>
373<!-- Bad URL
374 <tip>
375 <para>
376 There is a multitude of configuration parameters you can tweak to
377 customize <application>Thunderbird</application>. A very extensive,
378 but not so up-to-date list of these parameters can be found at
379 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
380 </para>
381 </tip>
382-->
383 <para>
384
385 If you use a desktop environment such as <application>GNOME</application>
386 or <application>KDE</application>, a desktop file
387 <filename>thunderbird.desktop</filename> may be created, in order to
388 include a <quote><application>Thunderbird</application></quote> entry in
389 the menu. <!--If you didn't enable
390 <application>startup-notification</application> in your mozconfig, then
391 change the StartupNotify line to false.--> Run the following commands as the
392 <systemitem class="username">root</systemitem> user:
393
394 </para>
395
396<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
397
398cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
399<literal>[Desktop Entry]
400Name=Thunderbird Mail
401Comment=Send and receive mail with Thunderbird
402GenericName=Mail Client
403Exec=thunderbird %u
404Terminal=false
405Type=Application
406Icon=thunderbird
407Categories=Network;Email;
408MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
409StartupNotify=true</literal>
410EOF
411
412ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
413 /usr/share/pixmaps/thunderbird.png</userinput></screen>
414 </sect3>
415 </sect2>
416
417 <sect2 role="content">
418 <title>Contents</title>
419
420 <segmentedlist>
421 <segtitle>Installed Program</segtitle>
422 <segtitle>Installed Libraries</segtitle>
423 <segtitle>Installed Directory</segtitle>
424
425 <seglistitem>
426 <seg>
427 thunderbird
428 </seg>
429 <seg>
430 Numerous libraries and modules in the /usr/lib/thunderbird directory
431 </seg>
432 <seg>
433 /usr/lib/thunderbird
434 </seg>
435 </seglistitem>
436 </segmentedlist>
437
438 <variablelist>
439 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
440 <?dbfo list-presentation="list"?>
441 <?dbhtml list-presentation="table"?>
442
443 <varlistentry id="thunderbird-prog">
444 <term><command>thunderbird</command></term>
445 <listitem>
446 <para>
447 is <application>Mozilla</application>'s email and newsgroup client
448 </para>
449 <indexterm zone="thunderbird thunderbird-prog">
450 <primary sortas="b-thunderbird">thunderbird</primary>
451 </indexterm>
452 </listitem>
453 </varlistentry>
454
455 </variablelist>
456
457 </sect2>
458
459</sect1>
Note: See TracBrowser for help on using the repository browser.