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:// af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 22.1 KB
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
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 ";/source/thunderbird-&thunderbird-version;-source.tar.bz2">
10 <!ENTITY thunderbird-download-ftp ";/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">
16 <!ENTITY thunderbird-enigmail-version "0.95.6">
17 <!ENTITY thunderbird-enigmail-download ";.tar.gz">
18 <!ENTITY thunderbird-enigmail-md5sum "cfbe6ff77f80a349b396829757ad952a">
19 <!ENTITY thunderbird-enigmail-size "1.1 MB">
22<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
23 <?dbhtml filename="thunderbird.html" ?>
25 <sect1info>
26 <othername>$LastChangedBy$</othername>
27 <date>$Date$</date>
28 </sect1info>
30 <title>Thunderbird-&thunderbird-version;</title>
32 <indexterm zone="thunderbird">
33 <primary sortas="a-Thunderbird">Thunderbird</primary>
34 </indexterm>
36 <sect2 role="package">
37 <title>Introduction to Thunderbird</title>
39 <para><application>Thunderbird</application> is a stand-alone
40 mail/news client based on the <application>Mozilla</application>
41 codebase.</para>
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>
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>
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>
85 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required"><xref linkend="gtk2"/>,
89 <xref linkend="libidl"/>, and
90 <xref linkend="zip"/></para>
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>
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>
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional"><xref linkend="unzip"/> and
107 <xref linkend="libgnomeui"/> (to build the gnomevfs extension)</para>
109 <para condition="html" role="usernotes">User Notes:
110 <ulink url="&blfs-wiki;/Thunderbird"/></para>
112 </sect2>
114 <sect2 role="installation">
115 <title>Installation of Thunderbird</title>
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>
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'.
145# Use the default settings specified in the source tree
146. $topsrcdir/mail/config/mozconfig
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
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
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
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
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
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
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
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
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
197# This option is used to enable source tree included LDAP support in
198# the Thunderbird binaries.
199ac_add_options --enable-ldap
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
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
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
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
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>
229 <para>Compile <application>Thunderbird</application> by
230 issuing the following commands:</para>
232<screen><userinput>cat &gt;&gt; layout/build/ &lt;&lt; "EOF" &amp;&amp;
234EXTRA_DSO_LDOPTS += $(XLDFLAGS) -lX11 -lXrender
238sed -i "s/^ enum$/&amp; xptinfo_enum_1/" \
239 xpcom/reflect/xptinfo/public/xptinfo.h &amp;&amp;
241make -f build</userinput></screen>
243 <para>This package does not come with a test suite.</para>
245 <para>If you're building the <application>Enigmail</application> extension,
246 issue the following commands:</para>
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;
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>
255 <para>Install <application>Thunderbird</application> by running the following
256 commands as the <systemitem class="username">root</systemitem> user:</para>
258<screen role="root"><userinput>make -f install &amp;&amp;
260install -v -m644 ../thunderbird-build/dist/public/ldap-private/* \
261 /usr/include/thunderbird-&thunderbird-version;/ldap &amp;&amp;
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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
316 <para>To enable multi-user operation, execute the following as the
317 <systemitem class="username">root</systemitem> user:</para>
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>
326 -->
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>
336 </sect2>
338 <sect2 role="commands">
339 <title>Command Explanations</title>
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>
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>
349 <para><command>make -f ...</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></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>
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>
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>
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>
372 </sect2>
374 <sect2 role="configuration">
375 <title>Configuring Thunderbird</title>
377 <sect3><title>Configuration Information</title>
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>
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>
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>
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>
429 <para>The configuration preference item you need to check so that
430 <application>Thunderbird</application> uses a specified browser is the
431 <parameter></parameter> which should
432 be set to the path of the desired browser, e.g.,
433 <option>/usr/bin/firefox</option>.</para>
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=""/>.</para>
440 </tip>
442 </sect3>
444 </sect2>
446 <sect2 role="content">
447 <title>Contents</title>
449 <segmentedlist>
450 <segtitle>Installed Programs</segtitle>
451 <segtitle>Installed Libraries</segtitle>
452 <segtitle>Installed Directories</segtitle>
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>
466 <variablelist>
467 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
468 <?dbfo list-presentation="list"?>
469 <?dbhtml list-presentation="table"?>
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>
482 </variablelist>
484 </sect2>
Note: See TracBrowser for help on using the repository browser.