source: xsoft/other/thunderbird.xml@ 989c203

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 989c203 was 989c203, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to xkbcomp-1.4.0 (xorg app).
Update to hdparm-9.52.
Update to thunderbird-52.1.0.
Update to libepoxy-1.4.2.
Update to cups-filters-1.13.4.

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

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