source: xsoft/other/thunderbird.xml@ 2f71e7b

10.0 10.1 11.0 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 2f71e7b was 2f71e7b, checked in by Dan Nichilson <dnicholson@…>, 15 years ago

Updated to thunderbird-2.0.0.0 + enigmail-0.95.0

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

  • Property mode set to 100644
File size: 22.0 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 "http://releases.mozilla.org/pub/mozilla.org/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;-source.tar.bz2">
8 <!ENTITY thunderbird-download-ftp "ftp://ftp.mozilla.org/pub/mozilla.org/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;-source.tar.bz2">
9 <!ENTITY thunderbird-md5sum "8e672d9f9206e0e1f03790dacb51e1bb">
10 <!ENTITY thunderbird-size "35.6 MB">
11 <!ENTITY thunderbird-buildsize "465 MB">
12 <!ENTITY thunderbird-time "12.3 SBU">
13
14 <!ENTITY thunderbird-enigmail-version "0.95.0">
15 <!ENTITY thunderbird-enigmail-download "http://www.mozilla-enigmail.org/downloads/src/enigmail-&thunderbird-enigmail-version;.tar.gz">
16 <!ENTITY thunderbird-enigmail-md5sum "820ab216b6ba21f81392d56bb9991c18">
17 <!ENTITY thunderbird-enigmail-size "556 KB">
18]>
19
20<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
21 <?dbhtml filename="thunderbird.html" ?>
22
23 <sect1info>
24 <othername>$LastChangedBy$</othername>
25 <date>$Date$</date>
26 </sect1info>
27
28 <title>Thunderbird-&thunderbird-version;</title>
29
30 <indexterm zone="thunderbird">
31 <primary sortas="a-Thunderbird">Thunderbird</primary>
32 </indexterm>
33
34 <sect2 role="package">
35 <title>Introduction to Thunderbird</title>
36
37 <para><application>Thunderbird</application> is a stand-alone
38 mail/news client based on the <application>Mozilla</application>
39 codebase.</para>
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>Download (HTTP): <ulink url="&thunderbird-download-http;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download (FTP): <ulink url="&thunderbird-download-ftp;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download MD5 sum: &thunderbird-md5sum;</para>
51 </listitem>
52 <listitem>
53 <para>Download size: &thunderbird-size;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated disk space required: &thunderbird-buildsize;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated build time: &thunderbird-time;</para>
60 </listitem>
61 </itemizedlist>
62
63 <para>To enable the <application>Enigmail</application> extension to the
64 <application>Thunderbird</application> mail client, you'll need to download
65 the tarball shown below. The <application>Enigmail</application> extension
66 allows users to access the authentication and encryption features provided
67 by the <application>GnuPG</application> package. The Enigmail extension
68 will not operate correctly unless you have <xref linkend="gnupg"/>
69 installed.</para>
70
71 <itemizedlist spacing='compact'>
72 <listitem>
73 <para><ulink url="&thunderbird-enigmail-download;"/></para>
74 </listitem>
75 <listitem>
76 <para>Download MD5 sum: &thunderbird-enigmail-md5sum;</para>
77 </listitem>
78 <listitem>
79 <para>Download size: &thunderbird-enigmail-size;</para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required"><xref linkend="gtk2"/>,
87 <xref linkend="libidl"/>, and
88 <xref linkend="zip"/></para>
89
90 <para>Note: <application>libjpeg</application> should have been installed
91 before <application>GTK+</application> and should exist on your system. If
92 for some reason you haven't installed <application>libjpeg</application>,
93 you should remove the <option>--with-system-jpeg</option> option from the
94 <filename>.mozconfig</filename> file created below.</para>
95
96 <bridgehead renderas="sect4">Recommended (if you will be installing any
97 other package that utilizes NSS/NSPR, such as
98 <application>Firefox</application>,
99 <application>Mozilla</application>,
100 <application>Evolution</application>, or
101 <application>OpenOffice</application>)</bridgehead>
102 <para role="recommended"><xref linkend="nss"/></para>
103
104 <bridgehead renderas="sect4">Optional</bridgehead>
105 <para role="optional"><xref linkend="unzip"/> and
106 <xref linkend="libgnomeui"/> (to build the gnomevfs extension)</para>
107
108 <para condition="html" role="usernotes">User Notes:
109 <ulink url="&blfs-wiki;/Thunderbird"/></para>
110
111 </sect2>
112
113 <sect2 role="installation">
114 <title>Installation of Thunderbird</title>
115
116 <para>The configuration of <application>Thunderbird</application> is
117 accomplished by creating a <filename>.mozconfig</filename> file containing
118 the desired configuration options. A default <filename>.mozconfig</filename>
119 is created below. To see the entire list of available configuration options
120 (and an abbreviated description of each one), issue
121 <command>./configure --help</command>. If you are going to use
122 system-installed versions of the <application>NSS</application> and
123 <application>NSPR</application> libraries, ensure you uncomment the two
124 lines near the bottom of the file. You may also wish to review the entire
125 file and uncomment any other desired options. If you would prefer to
126 download the file instead of creating it by typing or cut-and-pasting, you
127 can find it at <ulink
128 url="&files-anduin;/thunderbird-&thunderbird-version;-mozconfig"/>
129 (the file must be installed in the root of the source tree
130 <filename class='directory'>mozilla</filename> directory, and named
131 <filename>.mozconfig</filename>). Create the file by issuing the following
132 command:</para>
133
134<screen><userinput>cat &gt; .mozconfig &lt;&lt; "EOF"
135<literal># This file contains the options used in the Thunderbird build. You may
136# need to specify additional options for your specific build needs.
137# Use the information provided by running './configure --help' to
138# help you determine if you need to add any additional options.
139# Some additional options can be added by uncommenting the examples
140# in this file or adding options by inserting a line containing
141# 'ac_add_options --some-option-you-need'.
142
143
144# Use the default settings specified in the source tree
145. $topsrcdir/mail/config/mozconfig
146
147# Create an object directory and specify to build the package in that
148# directory. If desired, modify the location of the object directory
149# to a directory inside the source tree by removing '../' from the
150# line below.
151mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../thunderbird-build
152
153# Specify the installation prefix. If you would prefer Thunderbird
154# installed in a different prefix, modify the line below to fit
155# your needs. You'll also need to modify some of the instructions in
156# the BLFS book to point to your desired prefix.
157ac_add_options --prefix=/usr
158
159# These options are used so that the Thunderbird binaries are linked to
160# the system-installed copies of the specified libraries instead of
161# the source tree code which may not be the most recent versions.
162ac_add_options --with-system-zlib
163ac_add_options --with-system-png
164ac_add_options --with-system-jpeg
165ac_add_options --enable-system-cairo
166
167# This option causes the installed binaries to have the official
168# Thunderbird name embedded in them. Due to license restrictions, you
169# may not distribute binaries created using this option.
170ac_add_options --enable-official-branding
171
172# This option specifies to include support for rendering the HTML
173# &lt;canvas&gt;&lt;/canvas&gt; tag in the Thunderbird mail client.
174#ac_add_options --enable-canvas
175
176# This option is used so that the debugging symbols are removed from
177# the installed binaries during the installation process. Comment out
178# this option if you may have a need to retain the debugging symbols
179# in the installed binaries. Note that this can substantially
180# increase the size of the installed binaries.
181ac_add_options --enable-strip
182
183# This option is added so that test libraries and programs are not
184# built. These would only be required for debugging purposes.
185ac_add_options --disable-tests
186
187# This option is added so that the Mozilla Installer program is not
188# built or installed. The program is not required for a BLFS
189# installation of Thunderbird.
190ac_add_options --disable-installer
191
192# This option is used to disable the a11y support in the Thunderbird
193# binaries. Comment out this option if you require a11y support.
194ac_add_options --disable-accessibility
195
196# This option is used to enable source tree included LDAP support in
197# the Thunderbird binaries.
198ac_add_options --enable-ldap
199
200# This option is used to enable support for rendering SVG files in the
201# Thunderbird mail client. Uncomment the line below to enable the option.
202#ac_add_options --enable-svg
203
204# Uncomment this option if you desire support for dual-monitor
205# display of Thunderbird using the X-Window Xinerama libraries.
206#ac_add_options --enable-xinerama
207
208# Complex scripts such as Thai can only be rendered in Thunderbird with
209# the help of Pango. This option significantly slows rendering, so only
210# use it if necessary.
211#ac_add_options --enable-pango
212
213# These two options enable support for building Thunderbird with
214# system-installed versions of the Network Security Services (NSS)
215# and Netscape Portable Runtime (NSPR) libraries. Uncomment both
216# lines to enable support for system-installed NSS/NSPR.
217#ac_add_options --with-system-nss
218#ac_add_options --with-system-nspr
219
220# This option identifies the default binary directory of the Thunderbird
221# installation and is used to locate Thunderbird's installed files. This
222# option is not required for end-user use, and is only used for
223# development purposes.
224#ac_add_options --with-default-mozilla-five-home=/usr/lib/thunderbird-&thunderbird-version;</literal>
225
226EOF</userinput></screen>
227
228 <para>Compile <application>Thunderbird</application> by
229 issuing the following commands:</para>
230
231<screen><userinput>cat &gt;&gt; layout/build/Makefile.in &lt;&lt; "EOF" &amp;&amp;
232ifdef MOZ_ENABLE_CANVAS
233EXTRA_DSO_LDOPTS += -lX11 -lXrender
234endif
235EOF
236sed -i "s/^ enum$/&amp; xptinfo_enum_1/" \
237 xpcom/reflect/xptinfo/public/xptinfo.h &amp;&amp;
238make -f client.mk build</userinput></screen>
239
240 <para>This package does not come with a test suite.</para>
241
242 <para>If you're building the <application>Enigmail</application> extension,
243 issue the following commands:</para>
244
245<screen><userinput>tar -xf ../enigmail-&thunderbird-enigmail-version;.tar.gz -C mailnews/extensions &amp;&amp;
246( cd mailnews/extensions/enigmail &amp;&amp; ./makemake -r ) &amp;&amp;
247
248make -C ../thunderbird-build/mailnews/extensions/enigmail &amp;&amp;
249make -C ../thunderbird-build/mailnews/extensions/enigmail \
250 XPIFILE=enigmail-&thunderbird-enigmail-version;.xpi xpi</userinput></screen>
251
252 <para>Install <application>Thunderbird</application> by running the following
253 commands as the <systemitem class="username">root</systemitem> user:</para>
254
255<screen role="root"><userinput>make -f client.mk install &amp;&amp;
256
257install -v -m644 ../thunderbird-build/dist/public/ldap-private/* \
258 /usr/include/thunderbird-&thunderbird-version;/ldap &amp;&amp;
259
260install -v -m755 -d /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/en-US &amp;&amp;
261install -v -m644 ../thunderbird-build/dist/bin/isp/*.{rdf,sfd} \
262 /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/ &amp;&amp;
263install -v -m644 ../thunderbird-build/dist/bin/isp/en-US/*.rdf \
264 /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/en-US/</userinput></screen>
265
266 <para>If you built <application>Thunderbird</application> utilizing
267 system-installed NSS and NSPR libraries, the
268 <filename>thunderbird-ns*.pc</filename> <application>pkgconfig</application>
269 files are broken as they point to the wrong directories where the actual
270 libraries and interface headers are located. Issue the following commands
271 as the <systemitem class="username">root</systemitem> user to replace the
272 broken files with symbolic links to known good files:</para>
273
274<screen role="root"><userinput>ln -v -sf nss.pc /usr/lib/pkgconfig/thunderbird-nss.pc &amp;&amp;
275ln -v -sf nspr.pc /usr/lib/pkgconfig/thunderbird-nspr.pc</userinput></screen>
276
277 <para>If you did <emphasis role="strong">NOT</emphasis> build
278 <application>Thunderbird</application> utilizing system-installed NSS and
279 NSPR libraries, issue the following commands as the
280 <systemitem class="username">root</systemitem> user to install the NSS
281 interface headers:</para>
282
283<screen role="root"><userinput>install -v -m755 -d /usr/include/thunderbird-&thunderbird-version;/nss &amp;&amp;
284cp -v -Lf ../thunderbird-build/dist/{private,public}/nss/*.h \
285 /usr/include/thunderbird-&thunderbird-version;/nss</userinput></screen>
286
287 <para>If you built the <application>Enigmail</application> extension,
288 issue the following commands as the <systemitem
289 class="username">root</systemitem> user to install the
290 <filename>.xpi</filename> file:</para>
291
292<screen role="root"><userinput>install -v -m644 -D ../thunderbird-build/dist/bin/enigmail-&thunderbird-enigmail-version;.xpi \
293 /usr/lib/thunderbird-&thunderbird-version;/xpi_store/enigmail-&thunderbird-enigmail-version;.xpi</userinput></screen>
294
295 <para>If you want to install <application>Enigmail</application> globally
296 so that all users who run <application>Thunderbird</application> will have
297 access to the extension, issue the command shown below. Note that this
298 procedure starts an instance of <application>Thunderbird</application> and
299 you must have an X server running. Issue the following command as the
300 <systemitem class="username">root</systemitem> user:</para>
301
302<screen role="root"><userinput>/usr/bin/thunderbird -install-global-extension \
303 /usr/lib/thunderbird-&thunderbird-version;/xpi_store/enigmail-&thunderbird-enigmail-version;.xpi</userinput></screen>
304
305 <para>Global installation of other extensions can be done using the same
306 basic method as the <application>Enigmail</application> extension. See the
307 <quote>Configuring Thunderbird</quote> section below for information about
308 configuring <application>Enigmail</application> for individual users if you
309 did not not install it globally.</para>
310
311 <!-- This appears to not be required any longer. The regchrome program
312 is not built any longer, and multi-user access to Thunderbird appears
313 to work fine without running regxpcom and touching the files. -Randy
314
315 <para>To enable multi-user operation, execute the following as the
316 <systemitem class="username">root</systemitem> user:</para>
317
318<screen role="root"><userinput>cd /usr/lib/thunderbird-&thunderbird-version; &amp;&amp;
319export LD_LIBRARY_PATH="$PWD" &amp;&amp;
320export MOZILLA_FIVE_HOME="$PWD" &amp;&amp;
321./regxpcom &amp;&amp;
322./regchrome &amp;&amp;
323touch `find . -name *.rdf`</userinput></screen>
324
325 -->
326
327 <note>
328 <para>You should run <command>/usr/bin/thunderbird</command> once as the
329 <systemitem class="username">root</systemitem> user (or any user with
330 write privileges) to create some necessary additional files in the
331 <filename class='directory'>/usr/lib/thunderbird-&thunderbird-version;</filename>
332 directory.</para>
333 </note>
334
335 </sect2>
336
337 <sect2 role="commands">
338 <title>Command Explanations</title>
339
340 <para><command>'EXTRA_DSO_LDOPTS' += -lX11 -lXrender ...</command>:
341 Building the layout backend will break when the canvas element is enabled
342 without adding these two required libraries.</para>
343
344 <para><command>sed -i "s/^ enum$/&amp; xptinfo_enum_1/" ...</command>:
345 This command is used to fix an anonymous enum in an external/public
346 interface header file.</para>
347
348 <para><command>make -f client.mk ...</command>: Mozilla products are
349 packaged to allow the use of a configuration file which can be used to
350 pass the configuration settings to the <command>configure</command>
351 command. <command>make</command> uses the <filename>client.mk</filename>
352 file to get initial configuration and setup parameters, then depending on
353 the target parameter (<parameter>build</parameter> or
354 <parameter>install</parameter>), either runs the
355 <command>configure</command> script and compiles the package or installs
356 the package.</para>
357
358 <para><command>( cd mailnews/... &amp;&amp; ./makemake -r )</command>:
359 This command is used to recursively create <filename>Makefile</filename>s
360 in the <filename class='directory'>enigmail</filename> directory.</para>
361
362 <para><command>make -C ... xpi</command>: This command builds the
363 <application>Enigmail</application>
364 <filename class='extension'>.xpi</filename> file which is used to install
365 <application>Enigmail</application>.</para>
366
367 <para><command>install .../*.{rdf,sfd}</command>: These commands are used
368 to install a few mail extensions inadvertantly left out of the
369 installation script.</para>
370
371 </sect2>
372
373 <sect2 role="configuration">
374 <title>Configuring Thunderbird</title>
375
376 <sect3><title>Configuration Information</title>
377
378 <para>No specific configuration is required as long as the
379 <command>thunderbird</command> script is in the user's path. If
380 <application>Thunderbird</application> is installed in a non-standard
381 location, then make a symlink to the <command>thunderbird</command>
382 script in the <filename class="directory">/usr/bin</filename>
383 directory.</para>
384
385 <para>If you don't have privileges to install extensions globally, or
386 you prefer to not install global extensions, you can configure
387 <application>Thunderbird</application> on an individual user basis for
388 access to extensions. For example, if you built the
389 <application>Enigmail</application> extension and did not install it
390 globally, it can be installed on an as-needed basis for each user of the
391 system who may use <application>Thunderbird</application>. It is
392 accomplished through the <application>Thunderbird</application>
393 <quote>Tools</quote> menu. Choose the <quote>Extensions</quote> &ndash;
394 <quote>Install</quote> option and fill in the <quote>Look in:</quote>
395 field with <filename
396 class='directory'>/usr/lib/thunderbird-&thunderbird-version;/xpi_store</filename>.
397 You'll then see the
398 <filename>enigmail-&thunderbird-enigmail-version;-linux-????.xpi</filename>
399 file listed. Choose this file and click on <quote>Open</quote>, then
400 click on <quote>Install now</quote>. The
401 <application>Enigmail</application> extension will install and you will
402 be prompted to restart <application>Thunderbird</application>.</para>
403
404 <para>If your Window or Desktop Manager does not allow you to configure
405 a default browser, you can add a configuration parameter to
406 <application>Thunderbird</application> so that a browser will start when
407 when you click on an Internet/intranet/local URL. The procedure to check
408 or modify any of the configuration parameters is quite simple and the
409 instructions here can be used to view or modify any of the
410 parameters.</para>
411
412 <para>First, open the configuration dialog by opening the
413 <quote>Edit</quote> drop-down menu. Choose <quote>Preferences</quote>
414 and then click on the <quote>Advanced</quote> icon on the top menu
415 bar. Choose the <quote>General</quote> tab and click on the
416 <quote>Config Editor</quote> button. This will display a list of the
417 configuration preferences and information related to each one. You can
418 use the <quote>Filter:</quote> bar to enter search criteria and narrow
419 down the listed items. Changing a preference can be done using two
420 methods. One, if the preference has a boolean value (True/False), simply
421 double-click on the preference to toggle the value and two, for other
422 preferences simply right-click on the desired line, choose
423 <quote>Modify</quote> from the menu and change the value. Creating new
424 preference items is accomplished in the same way, except choose
425 <quote>New</quote> from the menu and provide the desired data into the
426 fields when prompted.</para>
427
428 <para>The configuration preference item you need to check so that
429 <application>Thunderbird</application> uses a specified browser is the
430 <parameter>network.protocol-handler.app.http</parameter> which should
431 be set to the path of the desired browser, e.g.,
432 <option>/usr/bin/firefox</option>.</para>
433
434 <tip>
435 <para>There is a multitude of configuration parameters you can tweak to
436 customize <application>Thunderbird</application>. A very extensive and
437 up-to-date list of these parameters can be found at <ulink
438 url="http://preferential.mozdev.org/preferences.html"/>.</para>
439 </tip>
440
441 </sect3>
442
443 </sect2>
444
445 <sect2 role="content">
446 <title>Contents</title>
447
448 <segmentedlist>
449 <segtitle>Installed Programs</segtitle>
450 <segtitle>Installed Libraries</segtitle>
451 <segtitle>Installed Directories</segtitle>
452
453 <seglistitem>
454 <seg>thunderbird and thunderbird-config</seg>
455 <seg>Numerous libraries, email/newsgroups components, plugins,
456 extensions, and helper modules installed in <filename
457 class='directory'>/usr/lib/thunderbird-&thunderbird-version;</filename>
458 </seg>
459 <seg>/usr/include/thunderbird-&thunderbird-version;,
460 /usr/lib/thunderbird-&thunderbird-version;, and
461 /usr/share/idl/thunderbird-&thunderbird-version;</seg>
462 </seglistitem>
463 </segmentedlist>
464
465 <variablelist>
466 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
467 <?dbfo list-presentation="list"?>
468 <?dbhtml list-presentation="table"?>
469
470 <varlistentry id="thunderbird-prog">
471 <term><command>thunderbird</command></term>
472 <listitem>
473 <para>is <application>Mozilla</application>'s next-generation
474 email and newsgroup client.</para>
475 <indexterm zone="thunderbird thunderbird-prog">
476 <primary sortas="b-thunderbird">thunderbird</primary>
477 </indexterm>
478 </listitem>
479 </varlistentry>
480
481 </variablelist>
482
483 </sect2>
484
485</sect1>
Note: See TracBrowser for help on using the repository browser.