source: xsoft/other/thunderbird.xml@ 4b1b99e8

elogind
Last change on this file since 4b1b99e8 was 4b1b99e8, checked in by DJ Lucas <dj@…>, 5 years ago

Merge to HEAD 21160.

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

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