source: xsoft/other/thunderbird.xml@ 1916905

10.0 10.1 11.0 8.4 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 1916905 was 1916905, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Cheese: Fix a bug that spammed useless deprecation warnings to logs, 1 per second
gnome-menus: Fix the Applications menu for sundry removal
Thunderbird: Add a note about memory usage when linking.

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