source: xsoft/other/thunderbird.xml@ 890843e

10.0 10.1 11.0 11.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind krejzi/svn lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 890843e was 890843e, checked in by Fernando de Oliveira <fernando@…>, 8 years ago

thunderbird-31.2.0.

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