source: xsoft/other/thunderbird.xml@ 30339015

10.0 10.1 11.0 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 30339015 was 30339015, checked in by Pierre Labastie <pieere@…>, 4 years ago

thunderbird-52.6.0

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

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