source: xsoft/other/thunderbird.xml@ 8c48797

6.3 6.3-rc3
Last change on this file since 8c48797 was 8c48797, checked in by Randy McMurchy <randy@…>, 14 years ago

Fixed broken Thunderbird download URLs

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

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