source: xsoft/other/thunderbird.xml@ 6968e3cb

11.1 lazarus trunk xry111/intltool xry111/test-20220226
Last change on this file since 6968e3cb was 6968e3cb, checked in by Douglas R. Reno <renodr@…>, 6 months ago

Package Updates and a buildfix

Update to Thunderbird-91.3.0
Update to Seamonkey-2.53.10
Update to webkitgtk-2.34.3
Update to nss-3.73.1
Fix building Firefox with wayland-1.20.

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