source: xsoft/other/thunderbird.xml@ 95965b6

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 95965b6 was 95965b6, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Update to plasma-5,15,0.
Minor dependency issues.
Make sassc visble in sysv book.

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