source: xsoft/other/thunderbird.xml@ 7dcab6e

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 7dcab6e was 7dcab6e, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to thunderbird-52.2.1.
Update to llvm-4.0.1.

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

  • Property mode set to 100644
File size: 15.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 "&mozilla-ftp;/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;.source.tar.xz">-->
9 <!ENTITY thunderbird-download-ftp " ">
10 <!ENTITY thunderbird-md5sum "df6ddc52046acd66503756c094c30e21">
11 <!ENTITY thunderbird-size "218 MB">
12 <!ENTITY thunderbird-buildsize "4.5 GB (109 MB installed)">
13 <!ENTITY thunderbird-time "15 SBU (with -j4, estimated 40 SBU with -j1)">
14]>
15
16<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
17 <?dbhtml filename="thunderbird.html" ?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
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 &lfs80_checked;
40 &gcc7_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">Thunderbird Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="alsa-lib"/>,
81 <xref linkend="gtk3"/>,
82 <xref linkend="zip"/>,
83 <xref linkend="unzip"/>, and
84 <xref linkend="yasm"/>
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="libevent"/>,
90 <xref linkend="libvpx"/>,
91 <xref linkend="nspr"/>,
92 <xref linkend="nss"/>, and
93 <xref linkend="sqlite"/>
94 </para>
95
96 <note>
97 <para>
98 If you don't install recommended dependencies,
99 then internal copies of those packages will
100 be used. They might be tested to work, but
101 they can be out of date or contain security
102 holes.
103 </para>
104 </note>
105
106 <note>
107 <para>
108 With <application>Thunderbird-31.0</application> and later versions,
109 you must have installed <application>Openssl</application> before
110 <application>Python 2</application>, or the build system will quickly
111 fail with output including "ImportError: cannot import name
112 HTTPSHandler". If you are in any doubt about this (e.g. upgrading from
113 an older version of Thunderbird), check if
114 <filename>/usr/lib/python&python2-majorver;/lib-dynload/_ssl.so</filename>
115 exists. If it does not, reinstall <xref linkend="python2"/> (after
116 installing <xref linkend="openssl"/> - the latest version of any
117 <emphasis>currently maintained</emphasis> version of Openssl should be
118 satisfactory if already installed - if that package has not already
119 been installed).
120 </para>
121 </note>
122
123 <bridgehead renderas="sect4">Optional</bridgehead>
124 <para role="optional">
125 <!-- <xref linkend="curl"/>, not in build log-->
126 <xref linkend="cyrus-sasl"/>,
127 <xref linkend="dbus-glib"/>,
128 <xref linkend="doxygen"/>,
129 <xref linkend="GConf"/>,
130 <!--<xref linkend="gst10-plugins-base"/> (with
131 <xref linkend="gst10-plugins-good"/> and
132 <xref linkend="gst10-libav"/> at runtime),-->
133 <xref linkend="llvm"/>,
134 <!-- <xref linkend="openjdk"/>, not in build log -->
135 <xref linkend="pulseaudio"/>,
136 <xref linkend="startup-notification"/>,
137 <xref linkend="wget"/>,
138 <xref linkend="wireless_tools"/>, and
139 <ulink url="http://hunspell.sourceforge.net/">Hunspell</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 <para>
151 The configuration of <application>Thunderbird</application> is
152 accomplished by creating a <filename>mozconfig</filename> file containing
153 the desired configuration options. A default
154 <filename>mozconfig</filename> is created below. To see the entire list
155 of available configuration options (and a brief description of each),
156 issue <command>mozilla/configure --help</command>. Create the file with
157 the following command:
158 </para>
159
160<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
161<literal># If you have a multicore machine, the build may be faster if using parallel
162# jobs. The build system automatically adds -jN to the "make" flags, where N
163# is the number of CPU cores. The option below is therefore useless, unless
164# you want to use a smaller number of jobs:
165#mk_add_options MOZ_MAKE_FLAGS="-j1"
166
167# If you have installed dbus-glib, comment out this line:
168ac_add_options --disable-dbus
169
170# If you have installed wireless-tools comment out this line:
171ac_add_options --disable-necko-wifi
172
173# Uncomment these lines if you have installed optional dependencies:
174#ac_add_options --enable-system-hunspell
175#ac_add_options --enable-startup-notification
176
177# Comment out following option if you have PulseAudio installed
178ac_add_options --disable-pulseaudio
179
180# Comment out following option if you have gconf installed
181ac_add_options --disable-gconf
182
183# If you want to compile the Mozilla Calendar, uncomment this line:
184#ac_add_options --enable-calendar
185
186# Comment out following options if you have not installed
187# recommended dependencies:
188ac_add_options --enable-system-sqlite
189ac_add_options --with-system-libevent
190ac_add_options --with-system-libvpx
191ac_add_options --with-system-nspr
192ac_add_options --with-system-nss
193ac_add_options --with-system-icu
194<!-- These do not seem to be needed any more
195# Set CFLAGS and CXXFLAGS to prevent segfaults due to aggressive
196# optimizations in GCC-6:
197export CFLAGS+=" -fno-delete-null-pointer-checks -fno-lifetime-dse -fno-schedule-insns2"
198export CXXFLAGS+=" -fno-delete-null-pointer-checks -fno-lifetime-dse -fno-schedule-insns2"
199-->
200# The BLFS editors recommend not changing anything below this line:
201ac_add_options --prefix=/usr
202ac_add_options --enable-application=mail
203
204ac_add_options --disable-crashreporter
205ac_add_options --disable-updater
206ac_add_options --disable-debug
207ac_add_options --disable-tests
208
209ac_add_options --enable-optimize=-O2
210ac_add_options --enable-strip
211ac_add_options --enable-install-strip
212
213ac_add_options --enable-gio
214ac_add_options --enable-official-branding
215ac_add_options --enable-safe-browsing
216ac_add_options --enable-url-classifier
217
218# Use internal cairo due to reports of unstable execution with
219# system cairo
220#ac_add_options --enable-system-cairo
221ac_add_options --enable-system-ffi
222ac_add_options --enable-system-pixman
223
224ac_add_options --with-pthreads
225
226ac_add_options --with-system-bz2
227ac_add_options --with-system-jpeg
228ac_add_options --with-system-png
229ac_add_options --with-system-zlib</literal>
230EOF</userinput></screen>
231
232 <para>
233 Compile <application>Thunderbird</application> by issuing the following
234 commands:
235 </para>
236
237 <note><para>
238 If you are compiling <application>Thunderbird</application> in chroot,
239 prepend <envar>SHELL=/bin/sh</envar> to the make command below.
240 </para></note>
241
242<screen><userinput>make -f client.mk</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>make -f client.mk install INSTALL_SDK= &amp;&amp;
254chown -R 0:0 /usr/lib/thunderbird-&thunderbird-version;</userinput></screen>
255
256<!-- thunderbuild directory does not exist anymore. Leaving as comment,
257in case an editor figures out how to install the development environment.
258 <para>
259 The above instruction just installs the parts you need to run
260 <application>Thunderbird</application>. Alternatively, if you want to
261 install the full <application>Thunderbird</application> development
262 environment, run the following command as the
263 <systemitem class="username">root</systemitem> user:
264 </para>
265
266<screen role="root"><userinput>make -C thunderbuild install</userinput></screen>
267-->
268 </sect2>
269
270 <sect2 role="commands">
271 <title>Command Explanations</title>
272<!-- might be necessary
273 <para>
274 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
275 version of thunderbird, an old bug has reappeared in 32-bit builds. With
276 optimization, the install fails with a Python error. This command will
277 fix i686 builds and preserve the optimization on x86_64.
278 </para>-->
279
280 <para>
281 <command>export CFLAGS= ... export CXXFLAGS= ...</command>: These
282 settings work around code which gcc6 would otherwise regard as
283 out-of-specification and allow it to produce a working program.
284 </para>
285
286 <para>
287 <command>make -f client.mk</command>: Mozilla products are packaged to
288 allow the use of a configuration file which can be used to pass the
289 configuration settings to the <command>configure</command> command.
290 <command>make</command> uses the <filename>client.mk</filename> file to
291 get initial configuration and setup parameters.
292 </para>
293
294 </sect2>
295
296 <sect2 role="configuration">
297 <title>Configuring Thunderbird</title>
298
299 <sect3><title>Configuration Information</title>
300
301 <para>
302 If your Window or Desktop Manager does not allow you to configure a
303 default browser, you can add a configuration parameter to
304 <application>Thunderbird</application> so that a browser will start when
305 when you click on an Internet/intranet/local URL. The procedure to check
306 or modify any of the configuration parameters is quite simple and the
307 instructions here can be used to view or modify any of the parameters.
308 </para>
309
310 <para>
311 First, open the configuration dialog by opening the <quote>Edit</quote>
312 drop-down menu. Choose <quote>Preferences</quote> and then click on the
313 <quote>Advanced</quote> icon on the top menu bar. Choose the
314 <quote>General</quote> tab and click on the <quote>Config Editor</quote>
315 button. This will display a list of the configuration preferences and
316 information related to each one. You can use the <quote>Filter:</quote>
317 bar to enter search criteria and narrow down the listed items. Changing
318 a preference can be done using two methods. One, if the preference has a
319 boolean value (True/False), simply double-click on the preference to
320 toggle the value and two, for other preferences simply right-click on
321 the desired line, choose <quote>Modify</quote> from the menu and change
322 the value. Creating new preference items is accomplished in the same
323 way, except choose <quote>New</quote> from the menu and provide the
324 desired data into the fields when prompted.
325 </para>
326
327 <para>
328 The configuration preference item you need to check so that
329 <application>Thunderbird</application> uses a specified browser is the
330 <parameter>network.protocol-handler.app.http</parameter> which should be
331 set to the path of the desired browser, e.g.
332 <option>/usr/bin/firefox</option>.
333 </para>
334
335 <tip>
336 <para>
337 There is a multitude of configuration parameters you can tweak to
338 customize <application>Thunderbird</application>. A very extensive,
339 but not so up-to-date list of these parameters can be found at
340 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
341 </para>
342 </tip>
343
344 <para>
345
346 If you use a desktop environment such as <application>GNOME</application>
347 or <application>KDE</application>, a desktop file
348 <filename>thunderbird.desktop</filename> may be created, in order to
349 include a <quote><application>Thunderbird</application></quote> entry in
350 the menu. If you didn't enable
351 <application>startup-notification</application> in your mozconfig, then
352 change the StartupNotify line to false. Run the following commands as the
353 <systemitem class="username">root</systemitem> user:
354
355 </para>
356
357<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
358
359cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
360<literal>[Desktop Entry]
361Encoding=UTF-8
362Name=Thunderbird Mail
363Comment=Send and receive mail with Thunderbird
364GenericName=Mail Client
365Exec=thunderbird %u
366Terminal=false
367Type=Application
368Icon=thunderbird
369Categories=Application;Network;Email;
370MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
371StartupNotify=true</literal>
372EOF
373
374ln -sfv /usr/lib/thunderbird-&thunderbird-version;/chrome/icons/default/default256.png \
375 /usr/share/pixmaps/thunderbird.png</userinput></screen>
376 </sect3>
377 </sect2>
378
379 <sect2 role="content">
380 <title>Contents</title>
381
382 <segmentedlist>
383 <segtitle>Installed Program</segtitle>
384 <segtitle>Installed Libraries</segtitle>
385 <segtitle>Installed Directory</segtitle>
386
387 <seglistitem>
388 <seg>
389 thunderbird
390 </seg>
391 <seg>
392 libldap60.so, liblgpllibs.so, libmozgtk.so, libmozsandbox.so,
393 libprldap60.so, and libxul.so
394 </seg>
395 <seg>
396 /usr/lib/thunderbird-&thunderbird-version;
397 </seg>
398 </seglistitem>
399 </segmentedlist>
400
401 <variablelist>
402 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
403 <?dbfo list-presentation="list"?>
404 <?dbhtml list-presentation="table"?>
405
406 <varlistentry id="thunderbird-prog">
407 <term><command>thunderbird</command></term>
408 <listitem>
409 <para>
410 is <application>Mozilla</application>'s email and newsgroup client.
411 </para>
412 <indexterm zone="thunderbird thunderbird-prog">
413 <primary sortas="b-thunderbird">thunderbird</primary>
414 </indexterm>
415 </listitem>
416 </varlistentry>
417
418 </variablelist>
419
420 </sect2>
421
422</sect1>
Note: See TracBrowser for help on using the repository browser.