source: xsoft/other/thunderbird.xml@ 87068b5

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 87068b5 was 87068b5, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Move deprecated gnome packages and gnucash to the archive.

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

  • Property mode set to 100644
File size: 13.4 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
8 "&mozilla-http;/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;.source.tar.bz2">
9 <!ENTITY thunderbird-download-ftp
10 "&mozilla-ftp;/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;.source.tar.bz2">
11 <!ENTITY thunderbird-md5sum "31f07c3911d1d6772831195af64db963">
12 <!ENTITY thunderbird-size "109 MB">
13 <!ENTITY thunderbird-buildsize "3.1 GB (90 MB installed)">
14 <!ENTITY thunderbird-time "29 SBU">
15]>
16
17<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
18 <?dbhtml filename="thunderbird.html" ?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Thunderbird-&thunderbird-version;</title>
26
27 <indexterm zone="thunderbird">
28 <primary sortas="a-Thunderbird">Thunderbird</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Thunderbird</title>
33
34 <para>
35 <application>Thunderbird</application> is a stand-alone mail/news client
36 based on the <application>Mozilla</application> codebase. It uses the
37 Gecko rendering engine to enable it to display and compose HTML emails.
38 </para>
39
40 &lfs73_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&thunderbird-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&thunderbird-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &thunderbird-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &thunderbird-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &thunderbird-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &thunderbird-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="alsa-lib"/>,
81 <xref linkend="gtk2"/>,
82 <xref linkend="zip"/> and
83 <xref linkend="unzip"/>
84 </para>
85
86 <bridgehead renderas="sect4">Recommended</bridgehead>
87 <para role="recommended">
88 <xref linkend="libevent"/>,
89 <xref linkend="libvpx"/>,
90 <xref linkend="nspr"/>,
91 <xref linkend="nss"/>,
92 <xref linkend="sqlite"/> and
93 <xref linkend="yasm"/>
94 </para>
95
96 <note>
97 <para>
98 If you don't install recommended dependencies,
99 then internal copies of those packages will
100 be used. They might be tested to work, but
101 they can be out of date or contain security
102 holes.
103 </para>
104 </note>
105
106 <bridgehead renderas="sect4">Optional</bridgehead>
107 <para role="optional">
108 <xref linkend="curl"/>,
109 <xref linkend="cyrus-sasl"/>,
110 <xref linkend="dbus-glib"/>,
111 <xref linkend="doxygen"/>,
112 <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
113 <xref linkend="libnotify"/>,
114 <xref linkend="startup-notification"/>,
115 <xref linkend="wget"/> and
116 <xref linkend="wireless_tools"/>
117 </para>
118
119 <para condition="html" role="usernotes">
120 User Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
121 </para>
122 </sect2>
123
124 <sect2 role="installation">
125 <title>Installation of Thunderbird</title>
126
127 <para>
128 The configuration of <application>Thunderbird</application> is
129 accomplished by creating a <filename>mozconfig</filename> file containing
130 the desired configuration options. A default
131 <filename>mozconfig</filename> is created below. To see the entire list of
132 available configuration options (and a brief description of each), issue
133 <command>./configure --help</command>. Create the file with the following
134 command:
135 </para>
136
137<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
138# If you have a multicore machine you can speed up the build by running
139# several jobs at once by uncommenting the following line and setting the
140# value to number of CPU cores:
141#mk_add_options MOZ_MAKE_FLAGS="-j4"
142
143# If you have installed DBus-Glib comment out this line:
144ac_add_options --disable-dbus
145
146# If you have installed wireless-tools comment out this line:
147ac_add_options --disable-necko-wifi
148
149# If you have installed libnotify comment out this line:
150ac_add_options --disable-libnotify
151
152# Uncomment these lines if you have installed optional dependencies:
153#ac_add_options --enable-system-hunspell
154#ac_add_options --enable-startup-notification
155
156# If you have not installed Yasm then uncomment this line:
157#ac_add_options --disable-webm
158
159# If you want to compile the Mozilla Calendar, uncomment this line:
160#ac_add_options --enable-calendar
161
162# Comment out following options if you have not installed
163# recommended dependencies:
164ac_add_options --enable-system-sqlite
165ac_add_options --with-system-libevent
166ac_add_options --with-system-libvpx
167ac_add_options --with-system-nspr
168ac_add_options --with-system-nss
169
170# It is recommended not to touch anything below this line
171ac_add_options --prefix=/usr
172
173ac_add_options --disable-crashreporter
174ac_add_options --disable-installer
175ac_add_options --disable-updater
176ac_add_options --disable-debug
177ac_add_options --disable-tests
178
179ac_add_options --enable-optimize
180ac_add_options --enable-strip
181ac_add_options --enable-install-strip
182
183ac_add_options --enable-gio
184ac_add_options --enable-official-branding
185ac_add_options --enable-safe-browsing
186ac_add_options --enable-url-classifier
187
188ac_add_options --enable-system-ffi
189ac_add_options --enable-system-pixman
190
191ac_add_options --with-pthreads
192
193ac_add_options --with-system-bz2
194ac_add_options --with-system-jpeg
195ac_add_options --with-system-png
196ac_add_options --with-system-zlib
197
198mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/thunderbuild
199EOF</userinput></screen>
200
201 <para>
202 Compile <application>Thunderbird</application> by issuing the following
203 commands:
204 </para>
205
206<screen><userinput>make -f client.mk &amp;&amp;
207make -C thunderbuild/mail/installer</userinput></screen>
208
209 <para>
210 This package does not come with a test suite.
211 </para>
212
213 <para>
214 Install <application>Thunderbird</application> by running the following
215 commands as the <systemitem class="username">root</systemitem> user:
216 </para>
217
218<screen role="root"><userinput>mkdir -pv /usr/lib/thunderbird-&thunderbird-version; &amp;&amp;
219tar -xvf thunderbuild/mozilla/dist/thunderbird-&thunderbird-version;.en-US.linux-$(uname -m).tar.bz2 \
220 -C /usr/lib/thunderbird-&thunderbird-version; --strip-components=1 &amp;&amp;
221ln -sfv ../lib/thunderbird-&thunderbird-version;/thunderbird /usr/bin</userinput></screen>
222
223 <para>
224 The above instructions just install the parts you need to run
225 <application>Thunderbird</application>. Alternatively, if you want to
226 install the full <application>Thunderbird</application> development
227 environment, run the following command as the
228 <systemitem class="username">root</systemitem> user:
229 </para>
230
231<screen role="root"><userinput>make -C thunderbuild install</userinput></screen>
232 </sect2>
233
234 <sect2 role="commands">
235 <title>Command Explanations</title>
236
237 <para>
238 <command>make -f client.mk</command>: Mozilla products are packaged to
239 allow the use of a configuration file which can be used to pass the
240 configuration settings to the <command>configure</command> command.
241 <command>make</command> uses the <filename>client.mk</filename> file to
242 get initial configuration and setup parameters.
243 </para>
244
245 <para>
246 <command>make -C thunderbuild/mail/installer</command>: this runs make in
247 the <filename class="directory">thunderbuild/mail/installer</filename>
248 folder. This gathers together all the parts of
249 <application>Thunderbird</application> and compresses them into a tarball.
250 </para>
251
252 <para>
253 <command>tar -xfv thunderbuild/mozilla/dist ...</command>: This untars
254 <application>Thunderbird</application>, the <option>-C</option> option
255 uncompresses the files in
256 <filename class="directory">/usr/lib/thunderbird-&thunderbird-version;</filename>.
257 The <option>--strip-components=1</option> option removes the leading
258 'thunderbird' directory from the filenames, allowing us to untar it into a
259 versioned directory.
260 </para>
261 </sect2>
262
263 <sect2 role="configuration">
264 <title>Configuring Thunderbird</title>
265
266 <sect3><title>Configuration Information</title>
267
268 <para>
269 If your Window or Desktop Manager does not allow you to configure a
270 default browser, you can add a configuration parameter to
271 <application>Thunderbird</application> so that a browser will start when
272 when you click on an Internet/intranet/local URL. The procedure to check
273 or modify any of the configuration parameters is quite simple and the
274 instructions here can be used to view or modify any of the parameters.
275 </para>
276
277 <para>
278 First, open the configuration dialog by opening the <quote>Edit</quote>
279 drop-down menu. Choose <quote>Preferences</quote> and then click on the
280 <quote>Advanced</quote> icon on the top menu bar. Choose the
281 <quote>General</quote> tab and click on the <quote>Config Editor</quote>
282 button. This will display a list of the configuration preferences and
283 information related to each one. You can use the <quote>Filter:</quote>
284 bar to enter search criteria and narrow down the listed items. Changing
285 a preference can be done using two methods. One, if the preference has a
286 boolean value (True/False), simply double-click on the preference to
287 toggle the value and two, for other preferences simply right-click on
288 the desired line, choose <quote>Modify</quote> from the menu and change
289 the value. Creating new preference items is accomplished in the same
290 way, except choose <quote>New</quote> from the menu and provide the
291 desired data into the fields when prompted.
292 </para>
293
294 <para>
295 The configuration preference item you need to check so that
296 <application>Thunderbird</application> uses a specified browser is the
297 <parameter>network.protocol-handler.app.http</parameter> which should be
298 set to the path of the desired browser, e.g.
299 <option>/usr/bin/firefox</option>.
300 </para>
301
302 <tip>
303 <para>
304 There is a multitude of configuration parameters you can tweak to
305 customize <application>Thunderbird</application>. A very extensive,
306 but not so up-to-date list of these parameters can be found at
307 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
308 </para>
309 </tip>
310
311 <para>
312 If you use a desktop environment like <application>GNOME</application> or
313 <application>KDE</application> you may wish to create a
314 <filename>thunderbird.desktop</filename> file so that
315 <application>Thunderbird</application> appears in the panel's menus. If
316 you didn't enable <application>startup-notification</application> in your
317 mozconfig then change the StartupNotify line to false. Run the following
318 commands as the <systemitem class="username">root</systemitem> user:
319 </para>
320
321<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
322mkdir -pv /usr/share/pixmaps &amp;&amp;
323
324cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
325[Desktop Entry]
326Encoding=UTF-8
327Name=Thunderbird Mail
328Comment=Send and receive mail with Thunderbird
329GenericName=Mail Client
330Exec=thunderbird %u
331Terminal=false
332Type=Application
333Icon=thunderbird
334Categories=Application;Network;Email;
335MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
336StartupNotify=true
337EOF
338
339ln -sfv /usr/lib/thunderbird-&thunderbird-version;/chrome/icons/default/default256.png \
340 /usr/share/pixmaps/thunderbird.png</userinput></screen>
341 </sect3>
342 </sect2>
343
344 <sect2 role="content">
345 <title>Contents</title>
346
347 <segmentedlist>
348 <segtitle>Installed Program</segtitle>
349 <segtitle>Installed Libraries</segtitle>
350 <segtitle>Installed Directory</segtitle>
351
352 <seglistitem>
353 <seg>
354 thunderbird
355 </seg>
356 <seg>
357 None
358 </seg>
359 <seg>
360 /usr/lib/thunderbird-&thunderbird-version;
361 </seg>
362 </seglistitem>
363 </segmentedlist>
364
365 <variablelist>
366 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
367 <?dbfo list-presentation="list"?>
368 <?dbhtml list-presentation="table"?>
369
370 <varlistentry id="thunderbird-prog">
371 <term><command>thunderbird</command></term>
372 <listitem>
373 <para>
374 is <application>Mozilla</application>'s email and newsgroup client.
375 </para>
376 <indexterm zone="thunderbird thunderbird-prog">
377 <primary sortas="b-thunderbird">thunderbird</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 </variablelist>
383
384 </sect2>
385
386</sect1>
Note: See TracBrowser for help on using the repository browser.