source: xsoft/other/thunderbird.xml@ 90bdf96d

10.0 10.1 11.0 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 90bdf96d was 90bdf96d, checked in by Tim Tassonis <stuff@…>, 4 years ago
  • Update to thunderbird-52.9.0
  • Update to samba-4.8.3

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