source: xsoft/other/thunderbird.xml@ 6e2729c

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 6e2729c was 6e2729c, checked in by Douglas R. Reno <renodr@…>, 21 months ago

Update to samba-4.14.0
Update to mercurial-5.7.1
Update to git-2.30.2
Update to Thunderbird-78.8.1
Update to iso-codes-4.6.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24365 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 14.2 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 "0af7dc247737238f7c5a625f4c5a64d1">
10 <!ENTITY thunderbird-size "337 MB">
11 <!ENTITY thunderbird-buildsize "5.3 GB (183 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 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Thunderbird-&thunderbird-version;</title>
26
27 <indexterm zone="thunderbird">
28 <primary sortas="a-Thunderbird">Thunderbird</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Thunderbird</title>
33
34 <para>
35 <application>Thunderbird</application> is a stand-alone mail/news client
36 based on the <application>Mozilla</application> codebase. It uses the
37 Gecko rendering engine to enable it to display and compose HTML emails.
38 </para>
39
40 &lfs101_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&thunderbird-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&thunderbird-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &thunderbird-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &thunderbird-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &thunderbird-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &thunderbird-time;
72 </para>
73 </listitem>
74 </itemizedlist>
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;-rustc1470-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# 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 to allow this to be compiled with <xref linkend="rust"/>:
222 </para>
223
224<screen><userinput remap="pre">patch -p1 -i ../thunderbird-&thunderbird-version;-rustc1470-1.patch</userinput></screen>
225-->
226
227 <para>
228 Compile <application>Thunderbird</application> by issuing the following
229 commands:
230 </para>
231
232 <note>
233 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
234 href="../../xincludes/mozshm.xml"/>
235
236 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
237 href="../../xincludes/mozmach.xml"/>
238
239 </note>
240
241<screen><userinput>export CC=gcc CXX=g++ &amp;&amp;
242./mach configure &amp;&amp;
243./mach build</userinput></screen>
244
245 <para>
246 This package does not come with a test suite.
247 </para>
248
249 <para>
250 Install <application>Thunderbird</application> by running the following
251 commands as the <systemitem class="username">root</systemitem> user:
252 </para>
253
254<screen role="root"><userinput>./mach install</userinput></screen>
255
256 </sect2>
257
258 <sect2 role="commands">
259 <title>Command Explanations</title>
260<!-- might be necessary, we need to verify this.
261 <para>
262 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
263 version of thunderbird, an old bug has reappeared in 32-bit builds. With
264 optimization, the install fails with a Python error. This command will
265 fix i686 builds and preserve the optimization on x86_64.
266 </para>-->
267
268 <para>
269 <command>CC=gcc CXX=g++ ./mach configure</command>:
270 <application>Thunderbird</application>
271 now uses this <application>python3</application> script to run the
272 configuration,
273 build and install. Forcing GCC causes the build to come out smaller
274 and run faster.
275 <!-- For more info, see Ticket #13969. ~12GB to ~5GB build size,
276 significantly smaller build time.-->
277 </para>
278
279 <para>
280 <option>./mach build --verbose</option>: Use this alternative if you
281 need details of which files are being compiled, together with any C or
282 C++ flags being used.
283 </para>
284
285 </sect2>
286
287 <sect2 role="configuration">
288 <title>Configuring Thunderbird</title>
289
290 <sect3><title>Configuration Information</title>
291
292 <para>
293 If your Window or Desktop Manager does not allow you to configure a
294 default browser, you can add a configuration parameter to
295 <application>Thunderbird</application> so that a browser will start when
296 you click on an Internet/intranet/local URL. The procedure to check
297 or modify any of the configuration parameters is quite simple and the
298 instructions here can be used to view or modify any of the parameters.
299 </para>
300
301 <para>
302 First, open the configuration dialog by opening the <quote>Edit</quote>
303 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
304 to the bottom of the page. Then, click the <quote>Config Editor</quote>
305 button. Click on the <quote>I accept the risk!</quote> button.
306 This will display a list of the configuration preferences and
307 information related to each one. You can use the <quote>Filter:</quote>
308 bar to enter search criteria and narrow down the listed items. Changing
309 a preference can be done using two methods. One, if the preference has a
310 boolean value (True/False), simply double-click on the preference to
311 toggle the value and two, for other preferences simply right-click on
312 the desired line, choose <quote>Modify</quote> from the menu and change
313 the value. Creating new preference items is accomplished in the same
314 way, except choose <quote>New</quote> from the menu and provide the
315 desired data into the fields when prompted.
316 </para>
317
318 <para>
319 The configuration preference item you need to check so that
320 <application>Thunderbird</application> uses a specified browser is the
321 <parameter>network.protocol-handler.app.http</parameter> which should be
322 set to the path of the desired browser, e.g.
323 <option>/usr/bin/firefox</option>.
324 </para>
325
326 <tip>
327 <para>
328 There is a multitude of configuration parameters you can tweak to
329 customize <application>Thunderbird</application>. A very extensive,
330 but not so up-to-date list of these parameters can be found at
331 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
332 </para>
333 </tip>
334
335 <para>
336
337 If you use a desktop environment such as <application>GNOME</application>
338 or <application>KDE</application>, a desktop file
339 <filename>thunderbird.desktop</filename> may be created, in order to
340 include a <quote><application>Thunderbird</application></quote> entry in
341 the menu. <!--If you didn't enable
342 <application>startup-notification</application> in your mozconfig, then
343 change the StartupNotify line to false.--> Run the following commands as the
344 <systemitem class="username">root</systemitem> user:
345
346 </para>
347
348<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
349
350cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
351<literal>[Desktop Entry]
352Name=Thunderbird Mail
353Comment=Send and receive mail with Thunderbird
354GenericName=Mail Client
355Exec=thunderbird %u
356Terminal=false
357Type=Application
358Icon=thunderbird
359Categories=Network;Email;
360MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
361StartupNotify=true</literal>
362EOF
363
364ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
365 /usr/share/pixmaps/thunderbird.png</userinput></screen>
366 </sect3>
367 </sect2>
368
369 <sect2 role="content">
370 <title>Contents</title>
371
372 <segmentedlist>
373 <segtitle>Installed Program</segtitle>
374 <segtitle>Installed Libraries</segtitle>
375 <segtitle>Installed Directory</segtitle>
376
377 <seglistitem>
378 <seg>
379 thunderbird
380 </seg>
381 <seg>
382 libldap60.so, libldif60.so, liblgpllibs.so, libmozgtk.so,
383 libmozsandbox.so, libmozsqlite3.so, libmozwayland.so,
384 libprldap60.so, librnp.so, and libxul.so, all in the
385 /usr/lib/thunderbird directory
386 </seg>
387 <seg>
388 /usr/lib/thunderbird
389 </seg>
390 </seglistitem>
391 </segmentedlist>
392
393 <variablelist>
394 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
395 <?dbfo list-presentation="list"?>
396 <?dbhtml list-presentation="table"?>
397
398 <varlistentry id="thunderbird-prog">
399 <term><command>thunderbird</command></term>
400 <listitem>
401 <para>
402 is <application>Mozilla</application>'s email and newsgroup client
403 </para>
404 <indexterm zone="thunderbird thunderbird-prog">
405 <primary sortas="b-thunderbird">thunderbird</primary>
406 </indexterm>
407 </listitem>
408 </varlistentry>
409
410 </variablelist>
411
412 </sect2>
413
414</sect1>
Note: See TracBrowser for help on using the repository browser.