source: xsoft/other/thunderbird.xml@ 315b576

12.0 12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 315b576 was 0bab4c8, checked in by Douglas R. Reno <renodr@…>, 10 months ago

Update to thunderbird-115.1.1

  • Property mode set to 100644
File size: 15.5 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 "e4694b8b4a61211a4a7a34e8c6878ff3">
10 <!ENTITY thunderbird-size "508 MB">
11 <!ENTITY thunderbird-buildsize "6.7 GB (236 MB installed)">
12 <!ENTITY thunderbird-time "22 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 &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="autoconf213"/>,
81 <xref linkend="cbindgen"/>,
82 <xref linkend="dbus-glib"/>,
83 <xref linkend="gtk3"/>,
84 <!--and <xref linkend="gtk2"/>,-->
85 <xref linkend="llvm"/> including clang, <!-- used by default if found -->
86 <xref linkend="nodejs"/>,
87 <xref linkend="pulseaudio"/> (or <xref linkend="alsa-lib"/> if you edit
88 the mozconfig; although it is now deprecated by mozilla),
89 <xref linkend="python3"/> (rebuilt with the sqlite module),
90 <xref linkend="startup-notification"/>,
91 <xref linkend="zip"/>, and
92 <xref linkend="unzip"/>
93 <!--<xref linkend="yasm"/>-->
94 </para>
95
96 <bridgehead renderas="sect4">Recommended</bridgehead>
97 <para role="recommended">
98 <!-- When using system ICU, a problem occurs where the calendar and mail
99 functions do not render correctly and it causes other strange
100 behavior to occur. See Ticket #18323 for more details, as well as
101 https://lore.kernel.org/distributions/075a20b1-869b-78f3-9ace-e106a4d43ac4@linuxlounge.net/T/#u -->
102 <!--<xref linkend="icu"/>,-->
103 <xref linkend="libevent"/>,
104 <xref linkend="libvpx"/>,
105 <xref linkend="nasm"/>,
106 <xref linkend="nspr"/>, and
107 <xref linkend="nss"/>
108 </para>
109
110 <note>
111 <para>
112 If you don't install recommended dependencies,
113 then internal copies of those packages will
114 be used. They might be tested to work, but
115 they can be out of date or contain security
116 holes.
117 </para>
118 </note>
119
120 <bridgehead renderas="sect4">Optional</bridgehead>
121 <para role="optional">
122 <!--<xref linkend="cyrus-sasl"/>,-->
123 <!--<xref linkend="doxygen"/>,-->
124 <!--<xref linkend="GConf"/>,-->
125 <xref role="runtime" linkend="pciutils"/> (runtime),
126 <xref linkend="wget"/>,
127 <xref linkend="wireless_tools"/>, and
128 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
129 </para>
130
131 <para condition="html" role="usernotes">
132 Editor Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
133 </para>
134 </sect2>
135
136 <sect2 role="installation">
137 <title>Installation of Thunderbird</title>
138
139 <note>
140 <para>
141 The build process for Thunderbird can use 8GB+ of RAM when linking.
142 Make sure that you have adequate swap or RAM before continuing.
143 </para>
144 </note>
145
146 <para>
147 The configuration of <application>Thunderbird</application> is
148 accomplished by creating a <filename>mozconfig</filename> file containing
149 the desired configuration options. A default
150 <filename>mozconfig</filename> is created below. To see the entire list
151 of available configuration options (and a brief description of each),
152 issue <command>./mach configure -- --help | less</command>. Create the file with
153 the following command:
154 </para>
155
156<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
157<literal># If you have a multicore machine, all cores will be used.
158
159# If you have installed wireless-tools comment out this line:
160ac_add_options --disable-necko-wifi
161
162# Uncomment the following option if you have not installed PulseAudio
163#ac_add_options --enable-audio-backends=alsa
164
165# Comment out following options if you have not installed
166# recommended dependencies:
167ac_add_options --with-system-libevent
168ac_add_options --with-system-libvpx
169ac_add_options --with-system-nspr
170ac_add_options --with-system-nss
171
172# The elf-hack causes failed installs on some machines.
173# It is supposed to improve startup time and it shrinks libxul.so
174# by a few MB - comment this if you know your machine is not affected.
175ac_add_options --disable-elf-hack
176
177# The BLFS editors recommend not changing anything below this line:
178ac_add_options --prefix=/usr
179ac_add_options --enable-application=comm/mail
180
181ac_add_options --disable-crashreporter
182ac_add_options --disable-updater
183ac_add_options --disable-debug
184ac_add_options --disable-debug-symbols
185ac_add_options --disable-tests
186
187ac_add_options --enable-optimize=-O2
188ac_add_options --enable-linker=gold
189ac_add_options --enable-strip
190ac_add_options --enable-install-strip
191
192ac_add_options --enable-official-branding
193
194ac_add_options --enable-system-ffi
195ac_add_options --enable-system-pixman
196
197ac_add_options --with-system-jpeg
198ac_add_options --with-system-png
199ac_add_options --with-system-zlib
200
201# Using sandboxed wasm libraries has been moved to all builds instead
202# of only mozilla automation builds. It requires extra llvm packages
203# and was reported to seriously slow the build. Disable it.
204ac_add_options --without-wasm-sandboxed-libraries</literal>
205EOF</userinput></screen>
206<!-- Fixed in 102.9
207 <para>
208 A change in cbindgen-0.24.2 causes a symbol to now be output by
209 cbindgen, but it has already been defined in a header. This sed
210 prevents the build from eventually failing:
211 </para>
212
213<screen><userinput>sed -i '/ROOT_CLIP_CHAIN/d' gfx/webrender_bindings/webrender_ffi.h</userinput></screen>
214-->
215<!-- Not needed with clang
216 https://bugzilla.mozilla.org/show_bug.cgi?id=1729459
217 <para>
218 If building on a 32 bit machine, the following sed works around
219 an issue with an incompatible <quote>double</quote> type in one
220 header file:
221 </para>
222
223<screen><userinput>case "$(uname -m)" in
224 i?86) sed -e '/typedef[ ]*double/s/double/long double/' \
225 -i modules/fdlibm/src/math_private.h ;;
226esac</userinput></screen>
227-->
228
229 <para>
230 Fix an issue occurring when building with GCC-13:
231 </para>
232
233<screen><userinput>sed -e '/&lt;exception&gt;/i#include &lt;cstdint&gt;' \
234 -i comm/third_party/rnp/src/libsexp/include/sexp/sexp-error.h</userinput></screen>
235
236 <para>
237 Now invoke the Python <command>mach</command> script to compile
238 <application>Thunderbird</application>:
239 </para>
240
241 <note>
242 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
243 href="../../xincludes/mozshm.xml"/>
244
245 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
246 href="../../xincludes/mozmach.xml"/>
247
248 </note>
249
250<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none &amp;&amp;
251export MOZBUILD_STATE_PATH=./mozbuild &amp;&amp;
252./mach configure &amp;&amp;
253./mach build</userinput></screen>
254
255 <para>
256 This package does not come with a test suite.
257 </para>
258
259 <para>
260 Install <application>Thunderbird</application> by running the following
261 commands as the <systemitem class="username">root</systemitem> user:
262 </para>
263
264<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none ./mach install</userinput></screen>
265<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
266 <para>
267 Empty the environment variables which were set above:
268 </para>
269
270<screen><userinput>unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE MOZBUILD_STATE_PATH</userinput></screen>
271
272 </sect2>
273
274 <sect2 role="commands">
275 <title>Command Explanations</title>
276
277 <para>
278 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none</command>: Use the
279 system python to create a virtual environment for <command>mach</command>
280 without downloading any python wheels nor using the system python modules.
281 This prevent version mismatches between system modules and bundled ones.
282 </para>
283
284 <para>
285 <command>./mach configure</command>: This validates the supplied
286 dependencies and the <filename>mozconfig</filename>.
287 </para>
288
289 <para>
290 <option>./mach build --verbose</option>: Use this alternative if you
291 need details of which files are being compiled, together with any C or
292 C++ flags being used.
293 </para>
294
295 <para>
296 <option>./mach build -jN</option>: The build should, by default, use
297 all the online CPU cores. If using all the cores causes the build to swap
298 because you have insufficient memory, using fewer cores can be faster.
299 </para>
300
301 <para>
302 <option><envar>CC=gcc CXX=g++</envar></option>: BLFS used to
303 prefer to use gcc and g++ instead of upstream's defaults of the
304 <application>clang</application> programs. With the release of
305 gcc-12 the build takes longer with gcc and g++, primarily because
306 of extra warnings, and is bigger. Set these environment variables
307 <emphasis>before you run the configure script</emphasis>
308 if you wish to continue to use gcc, g++. Building
309 with GCC on i?86 is currently broken.
310 </para>
311
312 </sect2>
313
314 <sect2 role="configuration">
315 <title>Configuring Thunderbird</title>
316
317 <sect3><title>Configuration Information</title>
318
319 <para>
320 If your Window Manager or Desktop Environment does not allow you to
321 configure a default browser, you can add a configuration parameter to
322 <application>Thunderbird</application> so that a browser will start when
323 you click on an Internet/intranet/local URL. The procedure to check
324 or modify any of the configuration parameters is quite simple and the
325 instructions here can be used to view or modify any of the parameters.
326 </para>
327
328 <para>
329 First, open the configuration dialog by opening the <quote>Edit</quote>
330 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
331 to the bottom of the page. Then, click the <quote>Config Editor</quote>
332 button. Click on the <quote>I accept the risk!</quote> button.
333 This will display a list of the configuration preferences and
334 information related to each one. You can use the <quote>Filter:</quote>
335 bar to enter search criteria and narrow down the listed items. Changing
336 a preference can be done using two methods. One, if the preference has a
337 boolean value (True/False), simply double-click on the preference to
338 toggle the value and two, for other preferences simply right-click on
339 the desired line, choose <quote>Modify</quote> from the menu and change
340 the value. Creating new preference items is accomplished in the same
341 way, except choose <quote>New</quote> from the menu and provide the
342 desired data into the fields when prompted.
343 </para>
344
345 <para>
346 The configuration preference item you need to check so that
347 <application>Thunderbird</application> uses a specified browser is the
348 <parameter>network.protocol-handler.app.http</parameter> which should be
349 set to the path of the desired browser, e.g.
350 <option>/usr/bin/firefox</option>.
351 </para>
352<!-- Bad URL
353 <tip>
354 <para>
355 There is a multitude of configuration parameters you can tweak to
356 customize <application>Thunderbird</application>. A very extensive,
357 but not so up-to-date list of these parameters can be found at
358 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
359 </para>
360 </tip>
361-->
362 <para>
363
364 If you use a desktop environment such as <application>GNOME</application>
365 or <application>KDE</application>, a desktop file
366 <filename>thunderbird.desktop</filename> may be created, in order to
367 include a <quote><application>Thunderbird</application></quote> entry in
368 the menu. <!--If you didn't enable
369 <application>startup-notification</application> in your mozconfig, then
370 change the StartupNotify line to false.--> Run the following commands as the
371 <systemitem class="username">root</systemitem> user:
372
373 </para>
374
375<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
376
377cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
378<literal>[Desktop Entry]
379Name=Thunderbird Mail
380Comment=Send and receive mail with Thunderbird
381GenericName=Mail Client
382Exec=thunderbird %u
383Terminal=false
384Type=Application
385Icon=thunderbird
386Categories=Network;Email;
387MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
388StartupNotify=true</literal>
389EOF
390
391ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
392 /usr/share/pixmaps/thunderbird.png</userinput></screen>
393 </sect3>
394 </sect2>
395
396 <sect2 role="content">
397 <title>Contents</title>
398
399 <segmentedlist>
400 <segtitle>Installed Program</segtitle>
401 <segtitle>Installed Libraries</segtitle>
402 <segtitle>Installed Directory</segtitle>
403
404 <seglistitem>
405 <seg>
406 thunderbird
407 </seg>
408 <seg>
409 Numerous libraries and modules in the /usr/lib/thunderbird directory
410 </seg>
411 <seg>
412 /usr/lib/thunderbird
413 </seg>
414 </seglistitem>
415 </segmentedlist>
416
417 <variablelist>
418 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
419 <?dbfo list-presentation="list"?>
420 <?dbhtml list-presentation="table"?>
421
422 <varlistentry id="thunderbird-prog">
423 <term><command>thunderbird</command></term>
424 <listitem>
425 <para>
426 is <application>Mozilla</application>'s email and newsgroup client
427 </para>
428 <indexterm zone="thunderbird thunderbird-prog">
429 <primary sortas="b-thunderbird">thunderbird</primary>
430 </indexterm>
431 </listitem>
432 </varlistentry>
433
434 </variablelist>
435
436 </sect2>
437
438</sect1>
Note: See TracBrowser for help on using the repository browser.