source: xsoft/other/thunderbird.xml@ 60a31248

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 upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 60a31248 was 60a31248, checked in by Randy McMurchy <randy@…>, 16 years ago

Updated all the links to files on the Anduin server to use entities

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

  • Property mode set to 100644
File size: 21.7 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> or
110 <application>Mozilla</application>)</bridgehead>
111 <para role="recommended"><xref linkend="nss"/></para>
112
113 <bridgehead renderas="sect4">Optional</bridgehead>
114 <para role="optional"><xref linkend="unzip"/> and
115 <xref linkend="libgnomeui"/> (to build the gnomevfs extension)</para>
116
117 </sect2>
118
119 <sect2 role="installation">
120 <title>Installation of Thunderbird</title>
121
122 <para>The configuration of <application>Thunderbird</application> is
123 accomplished by creating a <filename>.mozconfig</filename> file containing
124 the desired configuration options. A default <filename>.mozconfig</filename>
125 is created below. To see the entire list of available configuration options
126 (and an abbreviated description of each one), issue
127 <command>./configure --help</command>. If you are going to use
128 system-installed versions of the <application>NSS</application> and
129 <application>NSPR</application> libraries, ensure you uncomment the two
130 lines near the bottom of the file. You may also wish to review the entire
131 file and uncomment any other desired options. If you would prefer to
132 download the file instead of creating it by typing or cut-and-pasting, you
133 can find it at <ulink
134 url="&files-anduin;/thunderbird-&thunderbird-version;-mozconfig"/>
135 (the file must be installed in the root of the source tree
136 <filename class='directory'>mozilla</filename> directory, and named
137 <filename>.mozconfig</filename>). Create the file by issuing the following
138 command:</para>
139
140<screen><userinput>cat &gt; .mozconfig &lt;&lt; "EOF"
141<literal># This file contains the options used in the Thunderbird build. You may
142# need to specify additional options for your specific build needs.
143# Use the information provided by running './configure --help' to
144# help you determine if you need to add any additional options.
145# Some additional options can be added by uncommenting the examples
146# in this file or adding options by inserting a line containing
147# 'ac_add_options --some-option-you-need'.
148
149
150# Use the default settings specified in the source tree
151. $topsrcdir/mail/config/mozconfig
152
153# Create an object directory and specify to build the package in that
154# directory. If desired, modify the location of the object directory
155# to a directory inside the source tree by removing '../' from the
156# line below.
157mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../thunderbird-build
158
159# Specify the installation prefix. If you would prefer Thunderbird
160# installed in a different prefix, modify the line below to fit
161# your needs. You'll also need to modify some of the instructions in
162# the BLFS book to point to your desired prefix.
163ac_add_options --prefix=/usr
164
165# These options are used so that the Thunderbird binaries are linked to
166# the system-installed copies of the specified libraries instead of
167# the source tree code which may not be the most recent versions.
168ac_add_options --with-system-zlib
169ac_add_options --with-system-png
170ac_add_options --with-system-jpeg
171ac_add_options --enable-system-cairo
172
173# This option causes the installed binaries to have the official
174# Thunderbird name embedded in them. Due to license restrictions, you
175# may not distribute binaries created using this option.
176ac_add_options --enable-official-branding
177
178# This option specifies to include support for rendering the HTML
179# &lt;canvas&gt;&lt;/canvas&gt; tag in the Thunderbird mail client.
180#ac_add_options --enable-canvas
181
182# This option is used so that the debugging symbols are removed from
183# the installed binaries during the installation process. Comment out
184# this option if you may have a need to retain the debugging symbols
185# in the installed binaries. Note that this can substantially
186# increase the size of the installed binaries.
187ac_add_options --enable-strip
188
189# This option is added so that test libraries and programs are not
190# built. These would only be required for debugging purposes.
191ac_add_options --disable-tests
192
193# This option is added so that the Mozilla Installer program is not
194# built or installed. The program is not required for a BLFS
195# installation of Thunderbird.
196ac_add_options --disable-installer
197
198# This option is used to disable the a11y support in the Thunderbird
199# binaries. Comment out this option if you require a11y support.
200ac_add_options --disable-accessibility
201
202# This option is used to enable source tree included LDAP support in
203# the Thunderbird binaries.
204ac_add_options --enable-ldap
205
206# This option is used to enable support for rendering SVG files in the
207# Thunderbird mail client. Uncomment the line below to enable the option.
208#ac_add_options --enable-svg
209
210# Uncomment this option if you desire support for dual-monitor
211# display of Thunderbird using the X-Window Xinerama libraries.
212#ac_add_options --enable-xinerama
213
214# These two options enable support for building Thunderbird with
215# system-installed versions of the Network Security Services (NSS)
216# and Netscape Portable Runtime (NSPR) libraries. Uncomment both
217# lines to enable support for system-installed NSS/NSPR.
218#ac_add_options --with-system-nss
219#ac_add_options --with-system-nspr
220
221# This option identifies the default binary directory of the Thunderbird
222# installation and is used to locate Thunderbird's installed files. This
223# option is not required for end-user use, and is only used for
224# development purposes.
225#ac_add_options --with-default-mozilla-five-home=/usr/lib/thunderbird-&thunderbird-version;</literal>
226
227EOF</userinput></screen>
228
229 <para>If you have system-installed Network Security Services (NSS) and
230 Netscape Portable Runtime (NSPR) libraries and you uncommented the
231 appropriate lines in the <filename>.mozconfig</filename> file to utilize
232 them, apply the following patch:</para>
233
234<screen><userinput>patch -Np1 -i ../thunderbird-&thunderbird-version;-system_nss-1.patch</userinput></screen>
235
236 <para>Compile <application>Thunderbird</application> by
237 issuing the following commands:</para>
238
239<screen><userinput>sed -i "s/^ enum$/&amp; xptinfo_enum_1/" \
240 xpcom/reflect/xptinfo/public/xptinfo.h &amp;&amp;
241make -f client.mk build</userinput></screen>
242
243 <para>If you're building the <application>Enigmail</application> extension,
244 issue the following commands:</para>
245
246<screen><userinput>tar -xf ../enigmail-&thunderbird-enigmail-version;.tar.gz -C mailnews/extensions &amp;&amp;
247cd mailnews/extensions/enigmail &amp;&amp;
248
249./makemake -r &amp;&amp;
250cd ../../.. &amp;&amp;
251
252make -C ../thunderbird-build/mailnews/extensions/enigmail &amp;&amp;
253make -C ../thunderbird-build/mailnews/extensions/enigmail xpi</userinput></screen>
254
255 <para>Install <application>Thunderbird</application> by running the following
256 commands as the <systemitem class="username">root</systemitem> user:</para>
257
258<screen role="root"><userinput>make -f client.mk install &amp;&amp;
259
260install -v -m644 ../thunderbird-build/dist/public/ldap-private/* \
261 /usr/include/thunderbird-1.5/ldap &amp;&amp;
262
263install -v -m755 -d /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/US &amp;&amp;
264install -v -m644 mailnews/base/ispdata/movemail.rdf \
265 mail/extensions/newsblog/rss.rdf \
266 /usr/lib/thunderbird-&thunderbird-version;/defaults/isp &amp;&amp;
267ln -v -s ../{movemail,rss}.rdf \
268 /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/US</userinput></screen>
269
270 <para>If you built <application>Thunderbird</application> utilizing
271 system-installed NSS and NSPR libraries, the
272 <filename>thunderbird-ns*.pc</filename> <application>pkgconfig</application>
273 files need to be modified. Issue the following command as the
274 <systemitem class="username">root</systemitem> user:</para>
275
276<screen role="root"><userinput>sed -i 's|/thunderbird-1.5||' /usr/lib/pkgconfig/thunderbird-ns*.pc</userinput></screen>
277
278 <para>If you did <emphasis role="strong">NOT</emphasis> build
279 <application>Thunderbird</application> utilizing system-installed NSS and
280 NSPR libraries, issue the following commands as the
281 <systemitem class="username">root</systemitem> user to install the NSS
282 interface headers:</para>
283
284<screen role="root"><userinput>install -v -m755 -d /usr/include/thunderbird-&thunderbird-version;/nss &amp;&amp;
285cp -v -Lf ../thunderbird-build/dist/{private,public}/nss/*.h \
286 /usr/include/thunderbird-&thunderbird-version;/nss</userinput></screen>
287
288 <para>If you built the <application>Enigmail</application> extension,
289 issue the following commands as the <systemitem
290 class="username">root</systemitem> user to install the
291 <filename>.xpi</filename> file:</para>
292
293<screen role="root"><userinput>ENIGMAIL_FILENAME=$(basename \
294 `ls ../thunderbird-build/dist/bin/enigmail-&thunderbird-enigmail-version;-*.xpi`) &amp;&amp;
295
296install -v -m644 -D ../thunderbird-build/dist/bin/$ENIGMAIL_FILENAME \
297 usr/lib/thunderbird-1.5/xpi_store/$ENIGMAIL_FILENAME</userinput></screen>
298
299 <para>If you want to install <application>Enigmail</application> globally
300 so that all users who run <application>Thunderbird</application> will have
301 access to the extension, issue the command shown below. Note that this
302 procedure starts an instance of <application>Thunderbird</application> and
303 you must have an X server running. Issue the following command as the
304 <systemitem class="username">root</systemitem> user:</para>
305
306<screen role="root"><userinput>/usr/bin/thunderbird -install-global-extension \
307 /usr/lib/thunderbird-&thunderbird-version;/xpi_store/$ENIGMAIL_FILENAME</userinput></screen>
308
309 <para>Global installation of other extensions can be done using the same
310 basic method as the <application>Enigmail</application> extension. See the
311 <quote>Configuring Thunderbird</quote> section below for information about
312 configuring <application>Enigmail</application> for individual users if you
313 did not not install it globally.</para>
314
315 <!-- This appears to not be required any longer. The regchrome program
316 is not built any longer, and multi-user access to Thunderbird appears
317 to work fine without running regxpcom and touching the files. -Randy
318
319 <para>To enable multi-user operation, execute the following as the
320 <systemitem class="username">root</systemitem> user:</para>
321
322<screen role="root"><userinput>cd /usr/lib/thunderbird-&thunderbird-version; &amp;&amp;
323export LD_LIBRARY_PATH="$PWD" &amp;&amp;
324export MOZILLA_FIVE_HOME="$PWD" &amp;&amp;
325./regxpcom &amp;&amp;
326./regchrome &amp;&amp;
327touch `find . -name *.rdf`</userinput></screen>
328
329 -->
330
331 <note>
332 <para>You should run <command>/usr/bin/thunderbird</command> once as the
333 <systemitem class="username">root</systemitem> user (or any user with
334 write privileges) to create some necessary additional files in the
335 <filename class='directory'>/usr/lib/thunderbird-&thunderbird-version;</filename>
336 directory.</para>
337 </note>
338
339 </sect2>
340
341 <sect2 role="commands">
342 <title>Command Explanations</title>
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>./makemake -r</command>: This command is used to recursively
359 create <filename>Makefile</filename>s in the current directory.</para>
360
361 <para><command>make -C ... xpi</command>: This command builds the
362 <application>Enigmail</application>
363 <filename class='extension'>.xpi</filename> file which is used to install
364 <application>Enigmail</application>.</para>
365
366 <para><command>install .../movemail.rdf .../rss.rdf ...</command>: These
367 commands are used to install two files inadvertently left out of the
368 installation script.</para>
369
370 </sect2>
371
372 <sect2 role="configuration">
373 <title>Configuring Thunderbird</title>
374
375 <sect3><title>Configuration Information</title>
376
377 <para>No specific configuration is required as long as the
378 <command>thunderbird</command> script is in the user's path. If
379 <application>Thunderbird</application> is installed in a non-standard
380 location, then make a symlink to the <command>thunderbird</command>
381 script in the <filename class="directory">/usr/bin</filename>
382 directory.</para>
383
384 <para>If you don't have privileges to install extensions globally, or
385 you prefer to not install global extensions, you can configure
386 <application>Thunderbird</application> on an individual user basis for
387 access to extensions. For example, if you built the
388 <application>Enigmail</application> extension and did not install it
389 globally, it can be installed on an as-needed basis for each user of the
390 system who may use <application>Thunderbird</application>. It is
391 accomplished through the <application>Thunderbird</application>
392 <quote>Tools</quote> menu. Choose the <quote>Extensions</quote> &ndash;
393 <quote>Install</quote> option and fill in the <quote>Look in:</quote>
394 field with <filename
395 class='directory'>/usr/lib/thunderbird-&thunderbird-version;/xpi_store</filename>.
396 You'll then see the
397 <filename>enigmail-&thunderbird-enigmail-version;-linux-????.xpi</filename>
398 file listed. Choose this file and click on <quote>Open</quote>, then
399 click on <quote>Install now</quote>. The
400 <application>Enigmail</application> extension will install and you will
401 be prompted to restart <application>Thunderbird</application>.</para>
402
403 <para>If your Window or Desktop Manager does not allow you to configure
404 a default browser, you can add a configuration parameter to
405 <application>Thunderbird</application> so that a browser will start when
406 when you click on an Internet/intranet/local URL. The procedure to check
407 or modify any of the configuration parameters is quite simple and the
408 instructions here can be used to view or modify any of the
409 parameters.</para>
410
411 <para>First, open the configuration dialog by opening the
412 <quote>Edit</quote> drop-down menu. Choose <quote>Preferences</quote>
413 and then click on the <quote>Advanced</quote> icon on the top menu
414 bar. Choose the <quote>General</quote> tab and click on the
415 <quote>Config Editor</quote> button. This will display a list of the
416 configuration preferences and information related to each one. You can
417 use the <quote>Filter:</quote> bar to enter search criteria and narrow
418 down the listed items. Changing a preference can be done using two
419 methods. One, if the preference has a boolean value (True/False), simply
420 double-click on the preference to toggle the value and two, for other
421 preferences simply right-click on the desired line, choose
422 <quote>Modify</quote> from the menu and change the value. Creating new
423 preference items is accomplished in the same way, except choose
424 <quote>New</quote> from the menu and provide the desired data into the
425 fields when prompted.</para>
426
427 <para>The configuration preference item you need to check so that
428 <application>Thunderbird</application> uses a specified browser is the
429 <parameter>network.protocol-handler.app.http</parameter> which should
430 be set to the path of the desired browser, e.g.,
431 <option>/usr/bin/firefox</option>.</para>
432
433 <tip>
434 <para>There is a multitude of configuration parameters you can tweak to
435 customize <application>Thunderbird</application>. A very extensive and
436 up-to-date list of these parameters can be found at <ulink
437 url="http://preferential.mozdev.org/preferences.html"/>.</para>
438 </tip>
439
440 </sect3>
441
442 </sect2>
443
444 <sect2 role="content">
445 <title>Contents</title>
446
447 <segmentedlist>
448 <segtitle>Installed Programs</segtitle>
449 <segtitle>Installed Libraries</segtitle>
450 <segtitle>Installed Directories</segtitle>
451
452 <seglistitem>
453 <seg>thunderbird and thunderbird-config</seg>
454 <seg>Numerous libraries, email/newsgroups components, plugins,
455 extensions, and helper modules installed in <filename
456 class='directory'>/usr/lib/thunderbird-&thunderbird-version;</filename>
457 </seg>
458 <seg>/usr/include/thunderbird-&thunderbird-version;,
459 /usr/lib/thunderbird-&thunderbird-version;, and
460 /usr/share/idl/thunderbird-&thunderbird-version;</seg>
461 </seglistitem>
462 </segmentedlist>
463
464 <variablelist>
465 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
466 <?dbfo list-presentation="list"?>
467 <?dbhtml list-presentation="table"?>
468
469 <varlistentry id="thunderbird-prog">
470 <term><command>thunderbird</command></term>
471 <listitem>
472 <para>is <application>Mozilla</application>'s next-generation
473 email and newsgroup client.</para>
474 <indexterm zone="thunderbird thunderbird-prog">
475 <primary sortas="b-thunderbird">thunderbird</primary>
476 </indexterm>
477 </listitem>
478 </varlistentry>
479
480 </variablelist>
481
482 </sect2>
483
484</sect1>
Note: See TracBrowser for help on using the repository browser.