source: xsoft/other/thunderbird.xml@ 6473e74

10.0 10.1 11.0 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6473e74 was 6473e74, checked in by Randy McMurchy <randy@…>, 16 years ago

Removed excess EOL whitespace from all package instructions except for the 'x' chapters

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