source: xsoft/other/thunderbird.xml@ 5ccc18d

10.0 10.1 11.0 11.1 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 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 5ccc18d was 5ccc18d, checked in by Randy McMurchy <randy@…>, 14 years ago

Updated to SeaMonkey-1.1.8

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

  • Property mode set to 100644
File size: 21.9 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 "http://releases.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 "c23f576a8fd0ceee5135829c8ae5168b">
10 <!ENTITY thunderbird-size "37 MB">
11 <!ENTITY thunderbird-buildsize "629 MB">
12 <!ENTITY thunderbird-time "18 SBU">
13
14 <!ENTITY thunderbird-enigmail-version "0.95.6">
15 <!ENTITY thunderbird-enigmail-download "http://www.mozilla-enigmail.org/download/source/enigmail-&thunderbird-enigmail-version;.tar.gz">
16 <!ENTITY thunderbird-enigmail-md5sum "cfbe6ff77f80a349b396829757ad952a">
17 <!ENTITY thunderbird-enigmail-size "1.1 MB">
18]>
19
20<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
21 <?dbhtml filename="thunderbird.html" ?>
22
23 <sect1info>
24 <othername>$LastChangedBy$</othername>
25 <date>$Date$</date>
26 </sect1info>
27
28 <title>Thunderbird-&thunderbird-version;</title>
29
30 <indexterm zone="thunderbird">
31 <primary sortas="a-Thunderbird">Thunderbird</primary>
32 </indexterm>
33
34 <sect2 role="package">
35 <title>Introduction to Thunderbird</title>
36
37 <para><application>Thunderbird</application> is a stand-alone
38 mail/news client based on the <application>Mozilla</application>
39 codebase.</para>
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>Download (HTTP): <ulink url="&thunderbird-download-http;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download (FTP): <ulink url="&thunderbird-download-ftp;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download MD5 sum: &thunderbird-md5sum;</para>
51 </listitem>
52 <listitem>
53 <para>Download size: &thunderbird-size;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated disk space required: &thunderbird-buildsize;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated build time: &thunderbird-time;</para>
60 </listitem>
61 </itemizedlist>
62
63 <para>To enable the <application>Enigmail</application> extension to the
64 <application>Thunderbird</application> mail client, you'll need to download
65 the tarball shown below. The <application>Enigmail</application> extension
66 allows users to access the authentication and encryption features provided
67 by the <application>GnuPG</application> package. The Enigmail extension
68 will not operate correctly unless you have <xref linkend="gnupg"/> or
69 <xref linkend="gnupg2"/> installed.</para>
70
71 <itemizedlist spacing='compact'>
72 <listitem>
73 <para><ulink url="&thunderbird-enigmail-download;"/></para>
74 </listitem>
75 <listitem>
76 <para>Download MD5 sum: &thunderbird-enigmail-md5sum;</para>
77 </listitem>
78 <listitem>
79 <para>Download size: &thunderbird-enigmail-size;</para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required"><xref linkend="gtk2"/>,
87 <xref linkend="libidl"/>, and
88 <xref linkend="zip"/></para>
89
90 <para>Note: <application>libjpeg</application> should have been installed
91 before <application>GTK+</application> and should exist on your system. If
92 for some reason you haven't installed <application>libjpeg</application>,
93 you should remove the <option>--with-system-jpeg</option> option from the
94 <filename>.mozconfig</filename> file created below.</para>
95
96 <bridgehead renderas="sect4">Recommended</bridgehead>
97 <para role="recommended"><xref linkend="nss"/> (if you will be installing
98 any other package that utilizes NSS/NSPR, such as
99 <application>Firefox</application>, <application>SeaMonkey</application>,
100 <application>Evolution</application>, or
101 <application>OpenOffice</application>)</para>
102
103 <bridgehead renderas="sect4">Optional</bridgehead>
104 <para role="optional"><xref linkend="unzip"/> and
105 <xref linkend="libgnomeui"/> (to build the gnomevfs extension)</para>
106
107 <para condition="html" role="usernotes">User Notes:
108 <ulink url="&blfs-wiki;/Thunderbird"/></para>
109
110 </sect2>
111
112 <sect2 role="installation">
113 <title>Installation of Thunderbird</title>
114
115 <para>The configuration of <application>Thunderbird</application> is
116 accomplished by creating a <filename>.mozconfig</filename> file containing
117 the desired configuration options. A default <filename>.mozconfig</filename>
118 is created below. To see the entire list of available configuration options
119 (and an abbreviated description of each one), issue
120 <command>./configure --help</command>. If you are going to use
121 system-installed versions of the <application>NSS</application> and
122 <application>NSPR</application> libraries, ensure you uncomment the two
123 lines near the bottom of the file. You may also wish to review the entire
124 file and uncomment any other desired options. If you would prefer to
125 download the file instead of creating it by typing or cut-and-pasting, you
126 can find it at <ulink
127 url="&files-anduin;/thunderbird-&thunderbird-version;-mozconfig"/>
128 (the file must be installed in the root of the source tree
129 <filename class='directory'>mozilla</filename> directory, and named
130 <filename>.mozconfig</filename>). Create the file by issuing the following
131 command:</para>
132
133<screen><?dbfo keep-together="auto"?><userinput>cat &gt; .mozconfig &lt;&lt; "EOF"
134<literal># This file contains the options used in the Thunderbird build. You may
135# need to specify additional options for your specific build needs.
136# Use the information provided by running './configure --help' to
137# help you determine if you need to add any additional options.
138# Some additional options can be added by uncommenting the examples
139# in this file or adding options by inserting a line containing
140# 'ac_add_options --some-option-you-need'.
141
142
143# Use the default settings specified in the source tree
144. $topsrcdir/mail/config/mozconfig
145
146# Create an object directory and specify to build the package in that
147# directory. If desired, modify the location of the object directory
148# to a directory inside the source tree by removing '../' from the
149# line below.
150mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../thunderbird-build
151
152# Specify the installation prefix. If you would prefer Thunderbird
153# installed in a different prefix, modify the line below to fit
154# your needs. You'll also need to modify some of the instructions in
155# the BLFS book to point to your desired prefix.
156ac_add_options --prefix=/usr
157
158# These options are used so that the Thunderbird binaries are linked to
159# the system-installed copies of the specified libraries instead of
160# the source tree code which may not be the most recent versions.
161ac_add_options --with-system-zlib
162ac_add_options --with-system-png
163ac_add_options --with-system-jpeg
164ac_add_options --enable-system-cairo
165
166# This option causes the installed binaries to have the official
167# Thunderbird name embedded in them. Due to license restrictions, you
168# may not distribute binaries created using this option.
169ac_add_options --enable-official-branding
170
171# This option specifies to include support for rendering the HTML
172# &lt;canvas&gt;&lt;/canvas&gt; tag in the Thunderbird mail client.
173#ac_add_options --enable-canvas
174
175# This option is used so that the debugging symbols are removed from
176# the installed binaries during the installation process. Comment out
177# this option if you may have a need to retain the debugging symbols
178# in the installed binaries. Note that this can substantially
179# increase the size of the installed binaries.
180ac_add_options --enable-strip
181
182# This option is added so that test libraries and programs are not
183# built. These would only be required for debugging purposes.
184ac_add_options --disable-tests
185
186# This option is added so that the Mozilla Installer program is not
187# built or installed. The program is not required for a BLFS
188# installation of Thunderbird.
189ac_add_options --disable-installer
190
191# This option is used to disable the a11y support in the Thunderbird
192# binaries. Comment out this option if you require a11y support.
193ac_add_options --disable-accessibility
194
195# This option is used to enable source tree included LDAP support in
196# the Thunderbird binaries.
197ac_add_options --enable-ldap
198
199# This option is used to enable support for rendering SVG files in the
200# Thunderbird mail client. Uncomment the line below to enable the option.
201#ac_add_options --enable-svg
202
203# Uncomment this option if you desire support for dual-monitor
204# display of Thunderbird using the X-Window Xinerama libraries.
205#ac_add_options --enable-xinerama
206
207# Complex scripts such as Thai can only be rendered in Thunderbird with
208# the help of Pango. This option significantly slows rendering, so only
209# use it if necessary.
210#ac_add_options --enable-pango
211
212# These two options enable support for building Thunderbird with
213# system-installed versions of the Network Security Services (NSS)
214# and Netscape Portable Runtime (NSPR) libraries. Uncomment both
215# lines to enable support for system-installed NSS/NSPR.
216#ac_add_options --with-system-nss
217#ac_add_options --with-system-nspr
218
219# This option identifies the default binary directory of the Thunderbird
220# installation and is used to locate Thunderbird's installed files. This
221# option is not required for end-user use, and is only used for
222# development purposes.
223#ac_add_options --with-default-mozilla-five-home=/usr/lib/thunderbird-&thunderbird-version;</literal>
224
225EOF</userinput></screen>
226
227 <para>Compile <application>Thunderbird</application> by
228 issuing the following commands:</para>
229
230<screen><userinput>cat &gt;&gt; layout/build/Makefile.in &lt;&lt; "EOF" &amp;&amp;
231ifdef MOZ_ENABLE_CANVAS
232EXTRA_DSO_LDOPTS += $(XLDFLAGS) -lX11 -lXrender
233endif
234EOF
235
236sed -i "s/^ enum$/&amp; xptinfo_enum_1/" \
237 xpcom/reflect/xptinfo/public/xptinfo.h &amp;&amp;
238
239make -f client.mk build</userinput></screen>
240
241 <para>This package does not come with a test suite.</para>
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;
247( cd mailnews/extensions/enigmail &amp;&amp; ./makemake -r ) &amp;&amp;
248
249make -C ../thunderbird-build/mailnews/extensions/enigmail &amp;&amp;
250make -C ../thunderbird-build/mailnews/extensions/enigmail \
251 XPIFILE=enigmail-&thunderbird-enigmail-version;.xpi xpi</userinput></screen>
252
253 <para>Install <application>Thunderbird</application> by running the following
254 commands as the <systemitem class="username">root</systemitem> user:</para>
255
256<screen role="root"><userinput>make -f client.mk install &amp;&amp;
257
258install -v -m644 ../thunderbird-build/dist/public/ldap-private/* \
259 /usr/include/thunderbird-&thunderbird-version;/ldap &amp;&amp;
260
261install -v -m644 ../thunderbird-build/dist/bin/isp/{movemail,rss}.rdf \
262 /usr/lib/thunderbird-&thunderbird-version;/isp &amp;&amp;
263rm -rvf /usr/lib/thunderbird-&thunderbird-version;/defaults/isp</userinput></screen>
264
265 <para>If you built <application>Thunderbird</application> utilizing
266 system-installed NSS and NSPR libraries, the
267 <filename>thunderbird-ns*.pc</filename> <application>pkgconfig</application>
268 files are broken as they point to the wrong directories where the actual
269 libraries and interface headers are located. Issue the following commands
270 as the <systemitem class="username">root</systemitem> user to replace the
271 broken files with symbolic links to known good files:</para>
272
273<screen role="root"><userinput>ln -v -sf nss.pc /usr/lib/pkgconfig/thunderbird-nss.pc &amp;&amp;
274ln -v -sf nspr.pc /usr/lib/pkgconfig/thunderbird-nspr.pc</userinput></screen>
275
276 <para>If you did <emphasis role="strong">NOT</emphasis> build
277 <application>Thunderbird</application> utilizing system-installed NSS and
278 NSPR libraries, issue the following commands as the
279 <systemitem class="username">root</systemitem> user to install the NSS
280 interface headers:</para>
281
282<screen role="root"><userinput>install -v -m755 -d /usr/include/thunderbird-&thunderbird-version;/nss &amp;&amp;
283cp -v -Lf ../thunderbird-build/dist/{private,public}/nss/*.h \
284 /usr/include/thunderbird-&thunderbird-version;/nss</userinput></screen>
285
286 <para>If you built the <application>Enigmail</application> extension,
287 issue the following commands as the <systemitem
288 class="username">root</systemitem> user to install the
289 <filename>.xpi</filename> file:</para>
290
291<screen role="root"><userinput>install -v -m644 -D ../thunderbird-build/dist/bin/enigmail-&thunderbird-enigmail-version;.xpi \
292 /usr/lib/thunderbird-&thunderbird-version;/xpi_store/enigmail-&thunderbird-enigmail-version;.xpi</userinput></screen>
293
294 <para>If you want to install <application>Enigmail</application> globally
295 so that all users who run <application>Thunderbird</application> will have
296 access to the extension, issue the command shown below. Note that this
297 procedure starts an instance of <application>Thunderbird</application> and
298 you must have an X server running. Issue the following command as the
299 <systemitem class="username">root</systemitem> user:</para>
300
301<screen role="root"><userinput>/usr/bin/thunderbird -install-global-extension \
302 /usr/lib/thunderbird-&thunderbird-version;/xpi_store/enigmail-&thunderbird-enigmail-version;.xpi</userinput></screen>
303
304 <para>Global installation of other extensions can be done using the same
305 basic method as the <application>Enigmail</application> extension. See the
306 <quote>Configuring Thunderbird</quote> section below for information about
307 configuring <application>Enigmail</application> for individual users if you
308 did not not install it globally.</para>
309
310 <!-- This appears to not be required any longer. The regchrome program
311 is not built any longer, and multi-user access to Thunderbird appears
312 to work fine without running regxpcom and touching the files. -Randy
313
314 <para>To enable multi-user operation, execute the following as the
315 <systemitem class="username">root</systemitem> user:</para>
316
317<screen role="root"><userinput>cd /usr/lib/thunderbird-&thunderbird-version; &amp;&amp;
318export LD_LIBRARY_PATH="$PWD" &amp;&amp;
319export MOZILLA_FIVE_HOME="$PWD" &amp;&amp;
320./regxpcom &amp;&amp;
321./regchrome &amp;&amp;
322touch `find . -name *.rdf`</userinput></screen>
323
324 -->
325
326 <note>
327 <para>You should run <command>/usr/bin/thunderbird</command> once as the
328 <systemitem class="username">root</systemitem> user (or any user with
329 write privileges) to create some necessary additional files in the
330 <filename class='directory'>/usr/lib/thunderbird-&thunderbird-version;</filename>
331 directory.</para>
332 </note>
333
334 </sect2>
335
336 <sect2 role="commands">
337 <title>Command Explanations</title>
338
339 <para><command>'EXTRA_DSO_LDOPTS' += -lX11 -lXrender ...</command>:
340 Building the layout backend will break when the canvas element is enabled
341 without adding these two required libraries.</para>
342
343 <para><command>sed -i "s/^ enum$/&amp; xptinfo_enum_1/" ...</command>:
344 This command is used to fix an anonymous enum in an external/public
345 interface header file.</para>
346
347 <para><command>make -f client.mk ...</command>: Mozilla products are
348 packaged to allow the use of a configuration file which can be used to
349 pass the configuration settings to the <command>configure</command>
350 command. <command>make</command> uses the <filename>client.mk</filename>
351 file to get initial configuration and setup parameters, then depending on
352 the target parameter (<parameter>build</parameter> or
353 <parameter>install</parameter>), either runs the
354 <command>configure</command> script and compiles the package or installs
355 the package.</para>
356
357 <para><command>( cd mailnews/... &amp;&amp; ./makemake -r )</command>:
358 This command is used to recursively create <filename>Makefile</filename>s
359 in the <filename class='directory'>enigmail</filename> 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,rss}.rdf</command>: These commands
367 are used to install two mail extensions inadvertantly left out of the
368 installation script or installed to the wrong location.</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.