source: xsoft/other/thunderbird.xml@ 8b9ad6e

10.0 10.1 11.0 11.1 11.2 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 8b9ad6e was 8b9ad6e, checked in by Fernando de Oliveira <fernando@…>, 7 years ago
  • #6819 Move "Configuring lxqt-common" from "lxqt-common-0.9.1" to "lxqt-session-0.9.0" and rename it to "Configuring lxqt-session", because "lxqt-config-session" is installed there.
  • #6822 Update to thunderbird-38.2.0.
  • #6823 Update to ImageMagick-6.9.2-0.
  • #6824 short descriptions.
  • #6825 Update to LibRaw-0.17.0.

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

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