source: xsoft/other/thunderbird.xml@ f17ac396

11.0 lazarus qt5new trunk
Last change on this file since f17ac396 was f17ac396, checked in by Ken Moffat <ken@…>, 5 months ago

Thunderbird-78.10.0.

  • Property mode set to 100644
File size: 14.2 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 "&mozilla-http;/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;.source.tar.xz">
8 <!ENTITY thunderbird-download-ftp " ">
9 <!ENTITY thunderbird-md5sum "6efec9af1c47a1d27f39626c89848e84">
10 <!ENTITY thunderbird-size "336 MB">
11 <!ENTITY thunderbird-buildsize "5.3 GB (176 MB installed)">
12 <!ENTITY thunderbird-time "31 SBU (on a 4-core machine)">
13 <!-- Removed the -j1 time because python and rust do not obey it, although
14 the C/C++ code appears to obey it -->
15]>
16
17<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
18 <?dbhtml filename="thunderbird.html" ?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Thunderbird-&thunderbird-version;</title>
25
26 <indexterm zone="thunderbird">
27 <primary sortas="a-Thunderbird">Thunderbird</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Thunderbird</title>
32
33 <para>
34 <application>Thunderbird</application> is a stand-alone mail/news client
35 based on the <application>Mozilla</application> codebase. It uses the
36 Gecko rendering engine to enable it to display and compose HTML emails.
37 </para>
38
39 &lfs101_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&thunderbird-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&thunderbird-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &thunderbird-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &thunderbird-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &thunderbird-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &thunderbird-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74 <!--
75 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
76 <itemizedlist spacing="compact">
77 <listitem>
78 <para>
79 Required patch:
80 <ulink url="&patch-root;/thunderbird-&thunderbird-version;-rustc1470-1.patch"/>
81 </para>
82 </listitem>
83 </itemizedlist>
84 -->
85 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
86
87 <bridgehead renderas="sect4">Required</bridgehead>
88 <para role="required">
89<!-- <xref linkend="alsa-lib"/>, no mention in log -->
90 <xref linkend="autoconf213"/>,
91 <xref linkend="cbindgen"/>,
92 <xref linkend="dbus-glib"/>,
93 both <xref linkend="gtk3"/>
94 and <xref linkend="gtk2"/>,
95 <xref linkend="llvm"/> including clang, <!-- Searched for and used a few times -->
96 <xref linkend="nodejs"/>,
97 <xref linkend="pulseaudio"/> (or <xref linkend="alsa-lib"/> if you edit
98 the mozconfig; although it is now deprecated by mozilla),
99 <xref linkend="python3"/> (rebuilt with the sqlite module),
100 <xref linkend="startup-notification"/>,
101 <xref linkend="zip"/>,
102 <xref linkend="unzip"/>, and
103 <xref linkend="yasm"/>
104 </para>
105
106 <bridgehead renderas="sect4">Recommended</bridgehead>
107 <para role="recommended">
108 <xref linkend="icu"/>,
109 <xref linkend="libevent"/>,
110<!-- Fails to build with version 1.8.0
111 <xref linkend="libvpx"/>,-->
112 <xref linkend="nasm"/>,
113 <xref linkend="nspr"/>, and
114 <xref linkend="nss"/>
115 </para>
116
117 <note>
118 <para>
119 If you don't install recommended dependencies,
120 then internal copies of those packages will
121 be used. They might be tested to work, but
122 they can be out of date or contain security
123 holes.
124 </para>
125 </note>
126
127 <bridgehead renderas="sect4">Optional</bridgehead>
128 <para role="optional">
129 <!-- <xref linkend="curl"/>, not in build log-->
130 <xref linkend="cyrus-sasl"/>,
131 <xref linkend="doxygen"/>,
132 <xref linkend="GConf"/>,
133 <!--<xref linkend="gst10-plugins-base"/> (with
134 <xref linkend="gst10-plugins-good"/> and
135 <xref linkend="gst10-libav"/> at runtime),-->
136 <!-- <xref linkend="openjdk"/>, not in build log -->
137 <!--<xref linkend="pulseaudio"/>,-->
138 <xref linkend="wget"/>,
139 <xref linkend="wireless_tools"/>, and
140 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
141 </para>
142
143 <para condition="html" role="usernotes">
144 User Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
145 </para>
146 </sect2>
147
148 <sect2 role="installation">
149 <title>Installation of Thunderbird</title>
150
151 <note>
152 <para>
153 The build process for Thunderbird can use 8GB+ of RAM when linking.
154 Make sure that you have adequate swap or RAM before continuing.
155 </para>
156 </note>
157
158 <para>
159 The configuration of <application>Thunderbird</application> is
160 accomplished by creating a <filename>mozconfig</filename> file containing
161 the desired configuration options. A default
162 <filename>mozconfig</filename> is created below. To see the entire list
163 of available configuration options (and a brief description of each),
164 issue <command>mozilla/configure --help</command>. Create the file with
165 the following command:
166 </para>
167
168<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
169<literal># If you have a multicore machine, all cores will be used.
170
171# If you have installed wireless-tools comment out this line:
172ac_add_options --disable-necko-wifi
173
174# Uncomment the following option if you have not installed PulseAudio
175#ac_add_options --disable-pulseaudio
176# and uncomment this if you installed alsa-lib instead of PulseAudio
177#ac_add_options --enable-alsa
178<!-- always built in versions 78+. The option is a noop
179# If you want to compile the Mozilla Calendar, uncomment this line:
180#ac_add_options - -enable-calendar
181-->
182# Comment out following options if you have not installed
183# recommended dependencies:
184ac_add_options --with-system-libevent
185ac_add_options --with-system-nspr
186ac_add_options --with-system-nss
187ac_add_options --with-system-icu
188# The elf-hack causes failed installs on some machines.
189# It is supposed to improve startup time and it shrinks libxul.so
190# by a few MB - comment this if you know your machine is not affected.
191ac_add_options --disable-elf-hack
192
193# The BLFS editors recommend not changing anything below this line:
194ac_add_options --prefix=/usr
195ac_add_options --enable-application=comm/mail
196
197ac_add_options --disable-crashreporter
198ac_add_options --disable-updater
199ac_add_options --disable-debug
200ac_add_options --disable-debug-symbols
201ac_add_options --disable-tests
202
203ac_add_options --enable-optimize=-O2
204ac_add_options --enable-linker=gold
205ac_add_options --enable-strip
206ac_add_options --enable-install-strip
207
208ac_add_options --enable-official-branding
209
210ac_add_options --enable-system-ffi
211ac_add_options --enable-system-pixman
212
213ac_add_options --with-system-jpeg
214ac_add_options --with-system-png
215ac_add_options --with-system-zlib</literal>
216EOF</userinput></screen>
217
218<!--
219 <para>
220 Apply a patch to allow this to be compiled with <xref linkend="rust"/>:
221 </para>
222
223<screen><userinput remap="pre">patch -p1 -i ../thunderbird-&thunderbird-version;-rustc1470-1.patch</userinput></screen>
224-->
225
226 <para>
227 Compile <application>Thunderbird</application> by issuing the following
228 commands:
229 </para>
230
231 <note>
232 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
233 href="../../xincludes/mozshm.xml"/>
234
235 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
236 href="../../xincludes/mozmach.xml"/>
237
238 </note>
239
240<screen><userinput>export CC=gcc CXX=g++ &amp;&amp;
241./mach configure &amp;&amp;
242./mach build</userinput></screen>
243
244 <para>
245 This package does not come with a test suite.
246 </para>
247
248 <para>
249 Install <application>Thunderbird</application> by running the following
250 commands as the <systemitem class="username">root</systemitem> user:
251 </para>
252
253<screen role="root"><userinput>./mach install</userinput></screen>
254
255 </sect2>
256
257 <sect2 role="commands">
258 <title>Command Explanations</title>
259<!-- might be necessary, we need to verify this.
260 <para>
261 <command>test $(uname -m) = "i686" &amp;&amp; sed ...</command>: On this
262 version of thunderbird, an old bug has reappeared in 32-bit builds. With
263 optimization, the install fails with a Python error. This command will
264 fix i686 builds and preserve the optimization on x86_64.
265 </para>-->
266
267 <para>
268 <command>CC=gcc CXX=g++ ./mach configure</command>:
269 <application>Thunderbird</application>
270 now uses this <application>python3</application> script to run the
271 configuration,
272 build and install. Forcing GCC causes the build to come out smaller
273 and run faster.
274 <!-- For more info, see Ticket #13969. ~12GB to ~5GB build size,
275 significantly smaller build time.-->
276 </para>
277
278 <para>
279 <option>./mach build --verbose</option>: Use this alternative if you
280 need details of which files are being compiled, together with any C or
281 C++ flags being used.
282 </para>
283
284 </sect2>
285
286 <sect2 role="configuration">
287 <title>Configuring Thunderbird</title>
288
289 <sect3><title>Configuration Information</title>
290
291 <para>
292 If your Window or Desktop Manager does not allow you to configure a
293 default browser, you can add a configuration parameter to
294 <application>Thunderbird</application> so that a browser will start when
295 you click on an Internet/intranet/local URL. The procedure to check
296 or modify any of the configuration parameters is quite simple and the
297 instructions here can be used to view or modify any of the parameters.
298 </para>
299
300 <para>
301 First, open the configuration dialog by opening the <quote>Edit</quote>
302 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
303 to the bottom of the page. Then, click the <quote>Config Editor</quote>
304 button. Click on the <quote>I accept the risk!</quote> button.
305 This will display a list of the configuration preferences and
306 information related to each one. You can use the <quote>Filter:</quote>
307 bar to enter search criteria and narrow down the listed items. Changing
308 a preference can be done using two methods. One, if the preference has a
309 boolean value (True/False), simply double-click on the preference to
310 toggle the value and two, for other preferences simply right-click on
311 the desired line, choose <quote>Modify</quote> from the menu and change
312 the value. Creating new preference items is accomplished in the same
313 way, except choose <quote>New</quote> from the menu and provide the
314 desired data into the fields when prompted.
315 </para>
316
317 <para>
318 The configuration preference item you need to check so that
319 <application>Thunderbird</application> uses a specified browser is the
320 <parameter>network.protocol-handler.app.http</parameter> which should be
321 set to the path of the desired browser, e.g.
322 <option>/usr/bin/firefox</option>.
323 </para>
324
325 <tip>
326 <para>
327 There is a multitude of configuration parameters you can tweak to
328 customize <application>Thunderbird</application>. A very extensive,
329 but not so up-to-date list of these parameters can be found at
330 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
331 </para>
332 </tip>
333
334 <para>
335
336 If you use a desktop environment such as <application>GNOME</application>
337 or <application>KDE</application>, a desktop file
338 <filename>thunderbird.desktop</filename> may be created, in order to
339 include a <quote><application>Thunderbird</application></quote> entry in
340 the menu. <!--If you didn't enable
341 <application>startup-notification</application> in your mozconfig, then
342 change the StartupNotify line to false.--> Run the following commands as the
343 <systemitem class="username">root</systemitem> user:
344
345 </para>
346
347<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
348
349cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
350<literal>[Desktop Entry]
351Name=Thunderbird Mail
352Comment=Send and receive mail with Thunderbird
353GenericName=Mail Client
354Exec=thunderbird %u
355Terminal=false
356Type=Application
357Icon=thunderbird
358Categories=Network;Email;
359MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
360StartupNotify=true</literal>
361EOF
362
363ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
364 /usr/share/pixmaps/thunderbird.png</userinput></screen>
365 </sect3>
366 </sect2>
367
368 <sect2 role="content">
369 <title>Contents</title>
370
371 <segmentedlist>
372 <segtitle>Installed Program</segtitle>
373 <segtitle>Installed Libraries</segtitle>
374 <segtitle>Installed Directory</segtitle>
375
376 <seglistitem>
377 <seg>
378 thunderbird
379 </seg>
380 <seg>
381 libldap60.so, libldif60.so, liblgpllibs.so, libmozgtk.so,
382 libmozsandbox.so, libmozsqlite3.so, libmozwayland.so,
383 libprldap60.so, librnp.so, and libxul.so, all in the
384 /usr/lib/thunderbird directory
385 </seg>
386 <seg>
387 /usr/lib/thunderbird
388 </seg>
389 </seglistitem>
390 </segmentedlist>
391
392 <variablelist>
393 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
394 <?dbfo list-presentation="list"?>
395 <?dbhtml list-presentation="table"?>
396
397 <varlistentry id="thunderbird-prog">
398 <term><command>thunderbird</command></term>
399 <listitem>
400 <para>
401 is <application>Mozilla</application>'s email and newsgroup client
402 </para>
403 <indexterm zone="thunderbird thunderbird-prog">
404 <primary sortas="b-thunderbird">thunderbird</primary>
405 </indexterm>
406 </listitem>
407 </varlistentry>
408
409 </variablelist>
410
411 </sect2>
412
413</sect1>
Note: See TracBrowser for help on using the repository browser.