source: xsoft/other/thunderbird.xml@ 95a5b485

10.0 10.1 11.0 11.1 11.2 11.3 12.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 kea ken/inkscape-core-mods krejzi/svn lazarus lxqt nosym perl-modules plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 95a5b485 was 95a5b485, checked in by Dan Nichilson <dnicholson@…>, 17 years ago

Updated firefox and thunderbird/enigmail. Closes #2150, #2151 and #2171.

git-svn-id: svn:// af4574ff-66df-0310-9fd7-8a98e5e911e0

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