source: xsoft/other/thunderbird.xml@ a541e080

11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a541e080 was a541e080, checked in by Pierre Labastie <pierre.labastie@…>, 9 months ago

Updates and a security fix

Fix a security issue in apr-1.7.0 (with a sed)
libgcrypt-1.9.4 (security fix)
libcap-2.53
openssh-8.7p1
thunderbird-91.0.3
qemu-6.1.0

  • Property mode set to 100644
File size: 14.7 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 "f08dd55b8b1b0baf2c38a88aa3734cf8">
10 <!ENTITY thunderbird-size "390 MB">
11 <!ENTITY thunderbird-buildsize "6.9 GB (201 MB installed)">
12 <!ENTITY thunderbird-time "29 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 &lfs101_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;-glibc234-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<!-- Fails to build with version 1.8.0
111 <xref linkend="libvpx"/>,-->
112 <xref linkend="nasm"/>,
113 <xref linkend="nspr"/>, and
114 <xref linkend="nss"/>
115 </para>
116
117 <note>
118 <para>
119 If you don't install recommended dependencies,
120 then internal copies of those packages will
121 be used. They might be tested to work, but
122 they can be out of date or contain security
123 holes.
124 </para>
125 </note>
126
127 <bridgehead renderas="sect4">Optional</bridgehead>
128 <para role="optional">
129 <!-- <xref linkend="curl"/>, not in build log-->
130 <xref linkend="cyrus-sasl"/>,
131 <xref linkend="doxygen"/>,
132 <xref linkend="GConf"/>,
133 <!--<xref linkend="gst10-plugins-base"/> (with
134 <xref linkend="gst10-plugins-good"/> and
135 <xref linkend="gst10-libav"/> at runtime),-->
136 <!-- <xref linkend="openjdk"/>, not in build log -->
137 <!--<xref linkend="pulseaudio"/>,-->
138 <xref linkend="wget"/>,
139 <xref linkend="wireless_tools"/>, and
140 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
141 </para>
142
143 <para condition="html" role="usernotes">
144 User Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
145 </para>
146 </sect2>
147
148 <sect2 role="installation">
149 <title>Installation of Thunderbird</title>
150
151 <note>
152 <para>
153 The build process for Thunderbird can use 8GB+ of RAM when linking.
154 Make sure that you have adequate swap or RAM before continuing.
155 </para>
156 </note>
157
158 <para>
159 The configuration of <application>Thunderbird</application> is
160 accomplished by creating a <filename>mozconfig</filename> file containing
161 the desired configuration options. A default
162 <filename>mozconfig</filename> is created below. To see the entire list
163 of available configuration options (and a brief description of each),
164 issue <command>mozilla/configure --help</command>. Create the file with
165 the following command:
166 </para>
167
168<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
169<literal># If you have a multicore machine, all cores will be used.
170
171# If you have installed wireless-tools comment out this line:
172ac_add_options --disable-necko-wifi
173
174# Uncomment the following option if you have not installed PulseAudio
175#ac_add_options --disable-pulseaudio
176# and uncomment this if you installed alsa-lib instead of PulseAudio
177#ac_add_options --enable-alsa
178<!-- always built in versions 78+. The option is a noop
179# If you want to compile the Mozilla Calendar, uncomment this line:
180#ac_add_options - -enable-calendar
181-->
182# Comment out following options if you have not installed
183# recommended dependencies:
184ac_add_options --with-system-libevent
185ac_add_options --with-system-nspr
186ac_add_options --with-system-nss
187ac_add_options --with-system-icu
188# The elf-hack causes failed installs on some machines.
189# It is supposed to improve startup time and it shrinks libxul.so
190# by a few MB - comment this if you know your machine is not affected.
191ac_add_options --disable-elf-hack
192
193# The BLFS editors recommend not changing anything below this line:
194ac_add_options --prefix=/usr
195ac_add_options --enable-application=comm/mail
196
197ac_add_options --disable-crashreporter
198ac_add_options --disable-updater
199ac_add_options --disable-debug
200ac_add_options --disable-debug-symbols
201ac_add_options --disable-tests
202
203ac_add_options --enable-optimize=-O2
204ac_add_options --enable-linker=gold
205ac_add_options --enable-strip
206ac_add_options --enable-install-strip
207
208ac_add_options --enable-official-branding
209
210ac_add_options --enable-system-ffi
211ac_add_options --enable-system-pixman
212
213ac_add_options --with-system-jpeg
214ac_add_options --with-system-png
215ac_add_options --with-system-zlib</literal>
216EOF</userinput></screen>
217
218 <para>
219 Apply a patch which allows compilation on systems running glibc-2.34:
220 </para>
221
222<screen><userinput remap="pre">patch -p1 -i ../thunderbird-&thunderbird-version;-glibc234-1.patch</userinput></screen>
223
224 <para>
225 Now invoke the Python <command>mach</command> script to compile
226 <application>Thunderbird</application>:
227 </para>
228
229 <note>
230 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
231 href="../../xincludes/mozshm.xml"/>
232
233 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
234 href="../../xincludes/mozmach.xml"/>
235
236 </note>
237
238<screen><userinput>export CC=gcc CXX=g++ &amp;&amp;
239export MACH_USE_SYSTEM_PYTHON=1 &amp;&amp;
240./mach create-mach-environment &amp;&amp;
241./mach configure &amp;&amp;
242./mach build</userinput></screen>
243
244 <para>
245 This package does not come with a test suite.
246 </para>
247
248 <para>
249 Install <application>Thunderbird</application> by running the following
250 commands as the <systemitem class="username">root</systemitem> user:
251 </para>
252
253<screen role="root"><userinput>MACH_USE_SYSTEM_PYTHON=1 ./mach install</userinput></screen>
254
255 <para>
256 Empty the environment variables which were set above:
257 </para>
258
259<screen><userinput>unset CC CXX MACH_USE_SYSTEM_PYTHON</userinput></screen>
260
261 </sect2>
262
263 <sect2 role="commands">
264 <title>Command Explanations</title>
265<!-- might be necessary, we need to verify this.
266 <para>
267 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
268 version of thunderbird, an old bug has reappeared in 32-bit builds. With
269 optimization, the install fails with a Python error. This command will
270 fix i686 builds and preserve the optimization on x86_64.
271 </para>-->
272
273 <para>
274 <command>CC=gcc CXX=g++ ./mach configure</command>:
275 <application>Thunderbird</application>
276 now uses this <application>python3</application> script to run the
277 configuration,
278 build and install. Forcing GCC causes the build to come out smaller
279 and run faster.
280 <!-- For more info, see Ticket #13969. ~12GB to ~5GB build size,
281 significantly smaller build time.-->
282 </para>
283
284 <para>
285 <command>MACH_USE_SYSTEM_PYTHON=1</command>: Use the system python
286 to create a virtual environment for <command>mach</command> without
287 downloading any python wheels.
288 </para>
289
290 <para>
291 <option>./mach build --verbose</option>: Use this alternative if you
292 need details of which files are being compiled, together with any C or
293 C++ flags being used.
294 </para>
295
296 </sect2>
297
298 <sect2 role="configuration">
299 <title>Configuring Thunderbird</title>
300
301 <sect3><title>Configuration Information</title>
302
303 <para>
304 If your Window or Desktop Manager does not allow you to configure a
305 default browser, you can add a configuration parameter to
306 <application>Thunderbird</application> so that a browser will start when
307 you click on an Internet/intranet/local URL. The procedure to check
308 or modify any of the configuration parameters is quite simple and the
309 instructions here can be used to view or modify any of the parameters.
310 </para>
311
312 <para>
313 First, open the configuration dialog by opening the <quote>Edit</quote>
314 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
315 to the bottom of the page. Then, click the <quote>Config Editor</quote>
316 button. Click on the <quote>I accept the risk!</quote> button.
317 This will display a list of the configuration preferences and
318 information related to each one. You can use the <quote>Filter:</quote>
319 bar to enter search criteria and narrow down the listed items. Changing
320 a preference can be done using two methods. One, if the preference has a
321 boolean value (True/False), simply double-click on the preference to
322 toggle the value and two, for other preferences simply right-click on
323 the desired line, choose <quote>Modify</quote> from the menu and change
324 the value. Creating new preference items is accomplished in the same
325 way, except choose <quote>New</quote> from the menu and provide the
326 desired data into the fields when prompted.
327 </para>
328
329 <para>
330 The configuration preference item you need to check so that
331 <application>Thunderbird</application> uses a specified browser is the
332 <parameter>network.protocol-handler.app.http</parameter> which should be
333 set to the path of the desired browser, e.g.
334 <option>/usr/bin/firefox</option>.
335 </para>
336
337 <tip>
338 <para>
339 There is a multitude of configuration parameters you can tweak to
340 customize <application>Thunderbird</application>. A very extensive,
341 but not so up-to-date list of these parameters can be found at
342 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
343 </para>
344 </tip>
345
346 <para>
347
348 If you use a desktop environment such as <application>GNOME</application>
349 or <application>KDE</application>, a desktop file
350 <filename>thunderbird.desktop</filename> may be created, in order to
351 include a <quote><application>Thunderbird</application></quote> entry in
352 the menu. <!--If you didn't enable
353 <application>startup-notification</application> in your mozconfig, then
354 change the StartupNotify line to false.--> Run the following commands as the
355 <systemitem class="username">root</systemitem> user:
356
357 </para>
358
359<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
360
361cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
362<literal>[Desktop Entry]
363Name=Thunderbird Mail
364Comment=Send and receive mail with Thunderbird
365GenericName=Mail Client
366Exec=thunderbird %u
367Terminal=false
368Type=Application
369Icon=thunderbird
370Categories=Network;Email;
371MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
372StartupNotify=true</literal>
373EOF
374
375ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
376 /usr/share/pixmaps/thunderbird.png</userinput></screen>
377 </sect3>
378 </sect2>
379
380 <sect2 role="content">
381 <title>Contents</title>
382
383 <segmentedlist>
384 <segtitle>Installed Program</segtitle>
385 <segtitle>Installed Libraries</segtitle>
386 <segtitle>Installed Directory</segtitle>
387
388 <seglistitem>
389 <seg>
390 thunderbird
391 </seg>
392 <seg>
393 libldap60.so, libldif60.so, liblgpllibs.so, libmozgtk.so,
394 libmozsandbox.so, libmozsqlite3.so, libmozwayland.so,
395 libprldap60.so, librnp.so, and libxul.so, all in the
396 /usr/lib/thunderbird directory
397 </seg>
398 <seg>
399 /usr/lib/thunderbird
400 </seg>
401 </seglistitem>
402 </segmentedlist>
403
404 <variablelist>
405 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
406 <?dbfo list-presentation="list"?>
407 <?dbhtml list-presentation="table"?>
408
409 <varlistentry id="thunderbird-prog">
410 <term><command>thunderbird</command></term>
411 <listitem>
412 <para>
413 is <application>Mozilla</application>'s email and newsgroup client
414 </para>
415 <indexterm zone="thunderbird thunderbird-prog">
416 <primary sortas="b-thunderbird">thunderbird</primary>
417 </indexterm>
418 </listitem>
419 </varlistentry>
420
421 </variablelist>
422
423 </sect2>
424
425</sect1>
Note: See TracBrowser for help on using the repository browser.