source: xsoft/other/thunderbird.xml@ 7694f49

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.8 7.9 8.0 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 nosym 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 7694f49 was 7694f49, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

Update to thunderbird-38.1.0.
Update to stunnel-5.20.
Update to libidn-1.31.
Update to perl module Unicode-Collate-1.14.

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

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