source: xsoft/other/thunderbird.xml@ a4a2cd17

10.0 10.1 11.0 11.1 8.4 9.0 9.1 bdubbs/svn elogind lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since a4a2cd17 was a4a2cd17, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

thunderbird-60.2.1

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

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