source: xsoft/other/thunderbird.xml@ a30a874

10.0 10.1 11.0 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a30a874 was a30a874, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Tags to finish xorg drivers.
Archive cirrus and vesa xorg drivers
Archive gnash.
Finish tagging X appplication packages

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

  • Property mode set to 100644
File size: 15.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
8 "&mozilla-http;/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;.source.tar.bz2">
9 <!ENTITY thunderbird-download-ftp
10 "&mozilla-ftp;/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;.source.tar.bz2">
11 <!ENTITY thunderbird-md5sum "d79f8d232f2ad3d501ac5ff5ca4ecbe8">
12 <!ENTITY thunderbird-size "164 MB">
13 <!ENTITY thunderbird-buildsize "3.7 GB (68 MB installed)">
14 <!ENTITY thunderbird-time "16 SBU (with -j4)">
15]>
16
17<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
18 <?dbhtml filename="thunderbird.html" ?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Thunderbird-&thunderbird-version;</title>
26
27 <indexterm zone="thunderbird">
28 <primary sortas="a-Thunderbird">Thunderbird</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Thunderbird</title>
33
34 <para>
35 <application>Thunderbird</application> is a stand-alone mail/news client
36 based on the <application>Mozilla</application> codebase. It uses the
37 Gecko rendering engine to enable it to display and compose HTML emails.
38 </para>
39
40 &lfs77_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&thunderbird-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&thunderbird-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &thunderbird-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &thunderbird-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &thunderbird-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &thunderbird-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="alsa-lib"/>,
81 <xref linkend="gtk2"/>,
82 <xref linkend="zip"/>,
83 <xref linkend="unzip"/>, and
84 <xref linkend="yasm"/>
85 </para>
86
87 <bridgehead renderas="sect4">Recommended</bridgehead>
88 <para role="recommended">
89 <xref linkend="libevent"/>,
90 <xref linkend="libvpx"/>,
91 <xref linkend="nspr"/>,
92 <xref linkend="nss"/>, and
93 <xref linkend="sqlite"/>
94 </para>
95
96 <note>
97 <para>
98 If you don't install recommended dependencies,
99 then internal copies of those packages will
100 be used. They might be tested to work, but
101 they can be out of date or contain security
102 holes.
103 </para>
104 </note>
105
106 <note>
107 <para>
108 With <application>Thunderbird-31.0</application> and later versions,
109 you must have installed <application>Openssl</application> before
110 <application>Python 2</application>, or the build system will quickly
111 fail with output including "ImportError: cannot import name
112 HTTPSHandler". If you are in any doubt about this (e.g. upgrading from
113 an older version of Thunderbird), check if
114 <filename>/usr/lib/python&python2-majorver;/lib-dynload/_ssl.so</filename>
115 exists. If it does not, reinstall <xref linkend="python2"/> (after
116 installing <xref linkend="openssl"/> - the latest version of any
117 <emphasis>currently maintained</emphasis> version of Openssl should be
118 satisfactory if already installed - if that package has not already
119 been installed).
120 </para>
121 </note>
122
123 <bridgehead renderas="sect4">Optional</bridgehead>
124 <para role="optional">
125 <xref linkend="curl"/>,
126 <xref linkend="cyrus-sasl"/>,
127 <xref linkend="dbus-glib"/>,
128 <xref linkend="doxygen"/>,
129 <xref linkend="gst-plugins-base"/> (with
130 <xref linkend="gst-plugins-good"/> and
131 <xref linkend="gst-ffmpeg"/> at runtime), or
132 <xref linkend="gst10-plugins-base"/> (with
133 <xref linkend="gst10-plugins-good"/> and
134 <xref linkend="gst10-libav"/> at runtime),
135 <xref linkend="libnotify"/>,
136 <xref linkend="openjdk"/>,
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# If you have installed libnotify comment out this line:
176ac_add_options --disable-libnotify
177
178# GStreamer is necessary for H.264 video playback in HTML5 Video Player;
179# to be enabled, also remember to set "media.gstreamer.enabled" to "true"
180# in about:config. If you have installed GStreamer 0.x.y, comment out this line:
181ac_add_options --disable-gstreamer
182# or uncomment this line, if you have installed GStreamer 1.x.y
183#ac_add_options --enable-gstreamer=1.0
184
185# Uncomment these lines if you have installed optional dependencies:
186#ac_add_options --enable-system-hunspell
187#ac_add_options --enable-startup-notification
188
189# Comment out following option if you have PulseAudio installed
190ac_add_options --disable-pulseaudio
191<!-- Uncommenting does not work
192# If you have not installed Yasm then uncomment this line:
193#ac_add_options - -disable-webm
194-->
195# If you want to compile the Mozilla Calendar, uncomment this line:
196#ac_add_options --enable-calendar
197
198# Comment out following options if you have not installed
199# recommended dependencies:
200ac_add_options --enable-system-sqlite
201ac_add_options --with-system-libevent
202ac_add_options --with-system-libvpx
203ac_add_options --with-system-nspr
204ac_add_options --with-system-nss
205ac_add_options --with-system-icu
206
207# The BLFS editors recommend not changing anything below this line:
208ac_add_options --prefix=/usr
209
210ac_add_options --disable-crashreporter
211ac_add_options --disable-installer
212ac_add_options --disable-updater
213ac_add_options --disable-debug
214ac_add_options --disable-tests
215
216ac_add_options --enable-optimize
217ac_add_options --enable-strip
218ac_add_options --enable-install-strip
219
220ac_add_options --enable-gio
221ac_add_options --enable-official-branding
222ac_add_options --enable-safe-browsing
223ac_add_options --enable-url-classifier
224
225ac_add_options --enable-system-cairo
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
235
236# Presently, this option is broken
237#mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/thunderbuild</literal>
238EOF</userinput></screen>
239<!--
240 <para>
241 First, a bug needs to be fixed. Notice that thunderbuild needs to match
242 the value used in mozconfig (above) for the object directory (MOZ_OBJDIR):
243 </para>
244
245<!-\- might be necessary
246test $(uname -m) = "i686" && sed -i 's/enable-optimize/disable-optimize/' mozconfig || true &&-\->
247<screen><userinput>mkdir -vp mozilla/thunderbuild</userinput></screen>-->
248
249 <para>
250 Compile <application>Thunderbird</application> by issuing the following
251 commands:
252 </para>
253
254 <note><para>
255 If you are compiling <application>Thunderbird</application> in chroot,
256 prepend <envar>SHELL=/bin/sh</envar> to the <!--first -->make command below.
257 </para></note>
258
259<screen><userinput>make -f client.mk<!--
260make -C thunderbuild/mail/installer--></userinput></screen>
261
262 <para>
263 This package does not come with a test suite.
264 </para>
265
266 <para>
267 Install <application>Thunderbird</application> by running the following
268 commands as the <systemitem class="username">root</systemitem> user:
269 </para>
270
271<!--<screen role="root"><userinput>mkdir -pv /usr/lib/thunderbird-&thunderbird-version; &amp;&amp;
272tar -xvf thunderbuild/mozilla/dist/thunderbird-&thunderbird-version;.en-US.linux-$(uname -m).tar.bz2 \
273 -C /usr/lib/thunderbird-&thunderbird-version; -\-strip-components=1 &amp;&amp;
274ln -sfv ../lib/thunderbird-&thunderbird-version;/thunderbird /usr/bin</userinput></screen>-->
275
276<screen role="root"><userinput>make -f client.mk install INSTALL_SDK= &amp;&amp;
277chown -R 0:0 /usr/lib/thunderbird-&thunderbird-version;</userinput></screen>
278
279 <para>
280 The above instruction just installs the parts you need to run
281 <application>Thunderbird</application>. Alternatively, if you want to
282 install the full <application>Thunderbird</application> development
283 environment, run the following command as the
284 <systemitem class="username">root</systemitem> user:
285 </para>
286
287<screen role="root"><userinput>make -C thunderbuild install</userinput></screen>
288
289 </sect2>
290
291 <sect2 role="commands">
292 <title>Command Explanations</title>
293<!-- might be necessary
294 <para>
295 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
296 version of thunderbird, an old bug has reappeared in 32-bit builds. With
297 optimization, the install fails with a Python error. This command will
298 fix i686 builds and preserve the optimization on x86_64.
299 </para>-->
300<!--
301 <para>
302 <command>mkdir -vp mozilla/thunderbuild</command>: fixes a build failure
303 of Makefile at the beginning of build, where a file cannot be found.
304 </para>-->
305
306 <para>
307 <command>make -f client.mk</command>: Mozilla products are packaged to
308 allow the use of a configuration file which can be used to pass the
309 configuration settings to the <command>configure</command> command.
310 <command>make</command> uses the <filename>client.mk</filename> file to
311 get initial configuration and setup parameters.
312 </para>
313
314 </sect2>
315
316 <sect2 role="configuration">
317 <title>Configuring Thunderbird</title>
318
319 <sect3><title>Configuration Information</title>
320
321 <para>
322 If your Window or Desktop Manager does not allow you to configure a
323 default browser, you can add a configuration parameter to
324 <application>Thunderbird</application> so that a browser will start when
325 when you click on an Internet/intranet/local URL. The procedure to check
326 or modify any of the configuration parameters is quite simple and the
327 instructions here can be used to view or modify any of the parameters.
328 </para>
329
330 <para>
331 First, open the configuration dialog by opening the <quote>Edit</quote>
332 drop-down menu. Choose <quote>Preferences</quote> and then click on the
333 <quote>Advanced</quote> icon on the top menu bar. Choose the
334 <quote>General</quote> tab and click on the <quote>Config Editor</quote>
335 button. This will display a list of the configuration preferences and
336 information related to each one. You can use the <quote>Filter:</quote>
337 bar to enter search criteria and narrow down the listed items. Changing
338 a preference can be done using two methods. One, if the preference has a
339 boolean value (True/False), simply double-click on the preference to
340 toggle the value and two, for other preferences simply right-click on
341 the desired line, choose <quote>Modify</quote> from the menu and change
342 the value. Creating new preference items is accomplished in the same
343 way, except choose <quote>New</quote> from the menu and provide the
344 desired data into the fields when prompted.
345 </para>
346
347 <para>
348 The configuration preference item you need to check so that
349 <application>Thunderbird</application> uses a specified browser is the
350 <parameter>network.protocol-handler.app.http</parameter> which should be
351 set to the path of the desired browser, e.g.
352 <option>/usr/bin/firefox</option>.
353 </para>
354
355 <tip>
356 <para>
357 There is a multitude of configuration parameters you can tweak to
358 customize <application>Thunderbird</application>. A very extensive,
359 but not so up-to-date list of these parameters can be found at
360 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
361 </para>
362 </tip>
363
364 <para>
365
366 If you use a desktop environment such as <application>GNOME</application>
367 or <application>KDE</application>, a desktop file
368 <filename>thunderbird.desktop</filename> may be created, in order to
369 include a <quote><application>Thunderbird</application></quote> entry in
370 the menu. If you didn't enable
371 <application>startup-notification</application> in your mozconfig, then
372 change the StartupNotify line to false. Run the following commands as the
373 <systemitem class="username">root</systemitem> user:
374
375 </para>
376
377<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
378
379cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
380<literal>[Desktop Entry]
381Encoding=UTF-8
382Name=Thunderbird Mail
383Comment=Send and receive mail with Thunderbird
384GenericName=Mail Client
385Exec=thunderbird %u
386Terminal=false
387Type=Application
388Icon=thunderbird
389Categories=Application;Network;Email;
390MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
391StartupNotify=true</literal>
392EOF
393
394ln -sfv /usr/lib/thunderbird-&thunderbird-version;/chrome/icons/default/default256.png \
395 /usr/share/pixmaps/thunderbird.png</userinput></screen>
396 </sect3>
397 </sect2>
398
399 <sect2 role="content">
400 <title>Contents</title>
401
402 <segmentedlist>
403 <segtitle>Installed Program</segtitle>
404 <segtitle>Installed Libraries</segtitle>
405 <segtitle>Installed Directory</segtitle>
406
407 <seglistitem>
408 <seg>
409 thunderbird
410 </seg>
411 <seg>
412 None
413 </seg>
414 <seg>
415 /usr/lib/thunderbird-&thunderbird-version;
416 </seg>
417 </seglistitem>
418 </segmentedlist>
419
420 <variablelist>
421 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
422 <?dbfo list-presentation="list"?>
423 <?dbhtml list-presentation="table"?>
424
425 <varlistentry id="thunderbird-prog">
426 <term><command>thunderbird</command></term>
427 <listitem>
428 <para>
429 is <application>Mozilla</application>'s email and newsgroup client.
430 </para>
431 <indexterm zone="thunderbird thunderbird-prog">
432 <primary sortas="b-thunderbird">thunderbird</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 </variablelist>
438
439 </sect2>
440
441</sect1>
Note: See TracBrowser for help on using the repository browser.