source: xsoft/other/thunderbird.xml@ 0c3e9be8

10.0 10.1 11.0 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 ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 0c3e9be8 was 0c3e9be8, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Add keybinder2-0.3.0.
Update to lxpanel-0.8.0.
xfce4-mixer-4.10.0: uncomment keybinder and replace broken ulink by xref.
Python-2.7.8, SeaMonkey-2.31, Firefox-34.0. and Thunderbird-31.3.0:

replace /usr/lib/python2.7 by /usr/lib/python&python2-majorver;.

libxklavier-5.3: typo.

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

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