source: xsoft/other/thunderbird.xml@ 45d03f93

11.2 trunk xry111/soup3
Last change on this file since 45d03f93 was 45d03f93, checked in by Ken Moffat <ken@…>, 3 months ago

Update to thunderbird-102.0 (security fix).

  • Property mode set to 100644
File size: 16.0 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 "fc033aefff22c745284c12d648affa1d">
10 <!ENTITY thunderbird-size "480 MB">
11 <!ENTITY thunderbird-buildsize "7.4 GB (202 MB installed)">
12 <!ENTITY thunderbird-time "25 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
17<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
18 <?dbhtml filename="thunderbird.html" ?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
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 &lfs111_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;-gcc12_fix-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="alsa-lib"/>, no mention in log -->
90 <xref linkend="autoconf213"/>,
91 <xref linkend="cbindgen"/>,
92 <xref linkend="dbus-glib"/>,
93 both <xref linkend="gtk3"/>
94 and <xref linkend="gtk2"/>,
95 <xref linkend="llvm"/> including clang, <!-- Searched for and used a few times -->
96 <xref linkend="nodejs"/>,
97 <xref linkend="pulseaudio"/> (or <xref linkend="alsa-lib"/> if you edit
98 the mozconfig; although it is now deprecated by mozilla),
99 <xref linkend="python3"/> (rebuilt with the sqlite module),
100 <xref linkend="startup-notification"/>,
101 <xref linkend="zip"/>,
102 <xref linkend="unzip"/>, and
103 <xref linkend="yasm"/>
104 </para>
105
106 <bridgehead renderas="sect4">Recommended</bridgehead>
107 <para role="recommended">
108 <xref linkend="icu"/>,
109 <xref linkend="libevent"/>,
110 <xref linkend="libvpx"/>,
111 <xref linkend="nasm"/>,
112 <xref linkend="nspr"/>, and
113 <xref linkend="nss"/>
114 </para>
115
116 <note>
117 <para>
118 If you don't install recommended dependencies,
119 then internal copies of those packages will
120 be used. They might be tested to work, but
121 they can be out of date or contain security
122 holes.
123 </para>
124 </note>
125
126 <bridgehead renderas="sect4">Optional</bridgehead>
127 <para role="optional">
128 <!-- <xref linkend="curl"/>, not in build log-->
129 <xref linkend="cyrus-sasl"/>,
130 <xref linkend="doxygen"/>,
131 <xref linkend="GConf"/>,
132 <!--<xref linkend="gst10-plugins-base"/> (with
133 <xref linkend="gst10-plugins-good"/> and
134 <xref linkend="gst10-libav"/> at runtime),-->
135 <!-- <xref linkend="openjdk"/>, not in build log -->
136 <!--<xref linkend="pulseaudio"/>,-->
137 <xref linkend="wget"/>,
138 <xref linkend="wireless_tools"/>, and
139 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
140 </para>
141
142 <para condition="html" role="usernotes">
143 User Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
144 </para>
145 </sect2>
146
147 <sect2 role="installation">
148 <title>Installation of Thunderbird</title>
149
150 <note>
151 <para>
152 The build process for Thunderbird can use 8GB+ of RAM when linking.
153 Make sure that you have adequate swap or RAM before continuing.
154 </para>
155 </note>
156
157 <para>
158 The configuration of <application>Thunderbird</application> is
159 accomplished by creating a <filename>mozconfig</filename> file containing
160 the desired configuration options. A default
161 <filename>mozconfig</filename> is created below. To see the entire list
162 of available configuration options (and a brief description of each),
163 issue <command>mozilla/configure --help</command>. Create the file with
164 the following command:
165 </para>
166
167<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
168<literal># If you have a multicore machine, all cores will be used.
169
170# If you have installed wireless-tools comment out this line:
171ac_add_options --disable-necko-wifi
172
173# Uncomment the following option if you have not installed PulseAudio
174#ac_add_options --disable-pulseaudio
175# and uncomment this if you installed alsa-lib instead of PulseAudio
176#ac_add_options --enable-alsa
177<!-- always built in versions 78+. The option is a noop
178# If you want to compile the Mozilla Calendar, uncomment this line:
179#ac_add_options - -enable-calendar
180-->
181# Comment out following options if you have not installed
182# recommended dependencies:
183ac_add_options --with-system-libevent
184ac_add_options --with-system-libvpx
185ac_add_options --with-system-nspr
186ac_add_options --with-system-nss
187ac_add_options --with-system-icu
188
189# The elf-hack causes failed installs on some machines.
190# It is supposed to improve startup time and it shrinks libxul.so
191# by a few MB - comment this if you know your machine is not affected.
192ac_add_options --disable-elf-hack
193
194# The BLFS editors recommend not changing anything below this line:
195ac_add_options --prefix=/usr
196ac_add_options --enable-application=comm/mail
197
198ac_add_options --disable-crashreporter
199ac_add_options --disable-updater
200ac_add_options --disable-debug
201ac_add_options --disable-debug-symbols
202ac_add_options --disable-tests
203
204ac_add_options --enable-optimize=-O2
205ac_add_options --enable-linker=gold
206ac_add_options --enable-strip
207ac_add_options --enable-install-strip
208
209ac_add_options --enable-official-branding
210
211ac_add_options --enable-system-ffi
212ac_add_options --enable-system-pixman
213
214ac_add_options --with-system-jpeg
215ac_add_options --with-system-png
216ac_add_options --with-system-zlib</literal>
217EOF</userinput></screen>
218
219
220<!--<para>
221 Apply a patch which allows compilation on systems with gcc-12:
222 </para>
223
224<screen><userinput remap="pre">patch -Np1 -i ../thunderbird-&thunderbird-version;-gcc12_fix-1.patch</userinput></screen>-->
225
226 <para>
227 A change in cbindgen-0.24.2 causes a symbol to now be output by
228 cbindgen, but it has already been defined in a header. This sed
229 prevents the build eventually failing:
230 </para>
231
232<screen><userinput>sed -i '/ROOT_CLIP_CHAIN/d' gfx/webrender_bindings/webrender_ffi.h</userinput></screen>
233
234<!-- applying this for 11.1: upstream haven't make their mind yet
235 https://bugzilla.mozilla.org/show_bug.cgi?id=1729459
236 Still not fixed in 102.0. -->
237 <para>
238 If building on a 32 bit machine, the following sed works around
239 an issue with an incompatible <quote>double</quote> type in one
240 header file:
241 </para>
242
243<screen><userinput>case "$(uname -m)" in
244 i?86) sed -e '/typedef[ ]*double/s/double/long double/' \
245 -i modules/fdlibm/src/math_private.h ;;
246esac</userinput></screen>
247
248 <para>
249 Now invoke the Python <command>mach</command> script to compile
250 <application>Thunderbird</application>:
251 </para>
252
253 <note>
254 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
255 href="../../xincludes/mozshm.xml"/>
256
257 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
258 href="../../xincludes/mozmach.xml"/>
259
260 </note>
261
262<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system &amp;&amp;
263./mach configure &amp;&amp;
264./mach build</userinput></screen>
265
266 <para>
267 This package does not come with a test suite.
268 </para>
269
270 <para>
271 Install <application>Thunderbird</application> by running the following
272 commands as the <systemitem class="username">root</systemitem> user:
273 </para>
274
275<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system ./mach install</userinput></screen>
276<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
277 <para>
278 Empty the environment variables which were set above:
279 </para>
280
281<screen><userinput>unset CC CXX MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE</userinput></screen>
282
283 </sect2>
284
285 <sect2 role="commands">
286 <title>Command Explanations</title>
287<!-- might be necessary, we need to verify this.
288 <para>
289 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
290 version of thunderbird, an old bug has reappeared in 32-bit builds. With
291 optimization, the install fails with a Python error. This command will
292 fix i686 builds and preserve the optimization on x86_64.
293 </para>-->
294
295 <para>
296 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=system</command>: Use the
297 system python to create a virtual environment for <command>mach</command>
298 without downloading any python wheels.
299 </para>
300
301 <para>
302 <command>./mach configure</command>: This validates the supplied
303 dependencies and the <filename>mozconfig</filename>.
304 </para>
305
306 <para>
307 <option>./mach build --verbose</option>: Use this alternative if you
308 need details of which files are being compiled, together with any C or
309 C++ flags being used.
310 </para>
311
312 <para>
313 <option>./mach build -jN</option>: The build should, by default, use
314 all the online CPU cores. If using all the cores causes the build to swap
315 because you have insufficient memory, using fewer cores can be faster.
316 </para>
317
318 <para>
319 <parameter><envar>CC=gcc CXX=g++</envar></parameter>: BLFS used to
320 prefer to use gcc and g++ instead of upstream's defaults of the
321 <application>clang</application> programs. With the release of
322 gcc-12 the build takes longer with gcc and g++, primarily because
323 of extra warnings, and is bigger. Set these environment variables
324 <emphasis>before you run the configure script</emphasis>
325 if you wish to continue to use gcc, g++.
326 </para>
327
328 </sect2>
329
330 <sect2 role="configuration">
331 <title>Configuring Thunderbird</title>
332
333 <sect3><title>Configuration Information</title>
334
335 <para>
336 If your Window or Desktop Manager does not allow you to configure a
337 default browser, you can add a configuration parameter to
338 <application>Thunderbird</application> so that a browser will start when
339 you click on an Internet/intranet/local URL. The procedure to check
340 or modify any of the configuration parameters is quite simple and the
341 instructions here can be used to view or modify any of the parameters.
342 </para>
343
344 <para>
345 First, open the configuration dialog by opening the <quote>Edit</quote>
346 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
347 to the bottom of the page. Then, click the <quote>Config Editor</quote>
348 button. Click on the <quote>I accept the risk!</quote> button.
349 This will display a list of the configuration preferences and
350 information related to each one. You can use the <quote>Filter:</quote>
351 bar to enter search criteria and narrow down the listed items. Changing
352 a preference can be done using two methods. One, if the preference has a
353 boolean value (True/False), simply double-click on the preference to
354 toggle the value and two, for other preferences simply right-click on
355 the desired line, choose <quote>Modify</quote> from the menu and change
356 the value. Creating new preference items is accomplished in the same
357 way, except choose <quote>New</quote> from the menu and provide the
358 desired data into the fields when prompted.
359 </para>
360
361 <para>
362 The configuration preference item you need to check so that
363 <application>Thunderbird</application> uses a specified browser is the
364 <parameter>network.protocol-handler.app.http</parameter> which should be
365 set to the path of the desired browser, e.g.
366 <option>/usr/bin/firefox</option>.
367 </para>
368
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 libldap60.so, libldif60.so, liblgpllibs.so, libmozgtk.so,
426 libmozsandbox.so, libmozsqlite3.so, libmozwayland.so,
427 libprldap60.so, librnp.so, and libxul.so, all in the
428 /usr/lib/thunderbird directory
429 </seg>
430 <seg>
431 /usr/lib/thunderbird
432 </seg>
433 </seglistitem>
434 </segmentedlist>
435
436 <variablelist>
437 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
438 <?dbfo list-presentation="list"?>
439 <?dbhtml list-presentation="table"?>
440
441 <varlistentry id="thunderbird-prog">
442 <term><command>thunderbird</command></term>
443 <listitem>
444 <para>
445 is <application>Mozilla</application>'s email and newsgroup client
446 </para>
447 <indexterm zone="thunderbird thunderbird-prog">
448 <primary sortas="b-thunderbird">thunderbird</primary>
449 </indexterm>
450 </listitem>
451 </varlistentry>
452
453 </variablelist>
454
455 </sect2>
456
457</sect1>
Note: See TracBrowser for help on using the repository browser.