source: xsoft/other/thunderbird.xml@ b674aa1

12.0 12.1 gimp3 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/for-12.3 xry111/llvm18 xry111/spidermonkey128 xry111/xf86-video-removal
Last change on this file since b674aa1 was 7799a88, checked in by Bruce Dubbs <bdubbs@…>, 14 months ago

Minor text change

  • Property mode set to 100644
File size: 15.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 "4113a557a9730e4af8891ee7d7e27883">
10 <!ENTITY thunderbird-size "507 MB">
11 <!ENTITY thunderbird-buildsize "7.3 GB (205 MB installed)">
12 <!ENTITY thunderbird-time "20 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 Version 102.3.3: I disabled all but 4 cores. SBU was 20 (2019 seconds)
17 -->
18]>
19
20<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
21 <?dbhtml filename="thunderbird.html" ?>
22
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 &lfs113_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
76 <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="autoconf213"/>,
81 <xref linkend="cbindgen"/>,
82 <xref linkend="dbus-glib"/>,
83 <xref linkend="gtk3"/>,
84 <!--and <xref linkend="gtk2"/>,-->
85 <xref linkend="llvm"/> including clang, <!-- used by default if found -->
86 <xref linkend="nodejs"/>,
87 <xref linkend="pulseaudio"/> (or <xref linkend="alsa-lib"/> if you edit
88 the mozconfig; although it is now deprecated by mozilla),
89 <xref linkend="python3"/> (rebuilt with the sqlite module),
90 <xref linkend="startup-notification"/>,
91 <xref linkend="zip"/>, and
92 <xref linkend="unzip"/>
93 <!--<xref linkend="yasm"/>-->
94 </para>
95
96 <bridgehead renderas="sect4">Recommended</bridgehead>
97 <para role="recommended">
98 <xref linkend="icu"/>,
99 <xref linkend="libevent"/>,
100 <xref linkend="libvpx"/>,
101 <xref linkend="nasm"/>,
102 <xref linkend="nspr"/>, and
103 <xref linkend="nss"/>
104 </para>
105
106 <note>
107 <para>
108 If you don't install recommended dependencies,
109 then internal copies of those packages will
110 be used. They might be tested to work, but
111 they can be out of date or contain security
112 holes.
113 </para>
114 </note>
115
116 <bridgehead renderas="sect4">Optional</bridgehead>
117 <para role="optional">
118 <!--<xref linkend="cyrus-sasl"/>,-->
119 <!--<xref linkend="doxygen"/>,-->
120 <!--<xref linkend="GConf"/>,-->
121 <xref linkend="wget"/>,
122 <xref linkend="wireless_tools"/>, and
123 <ulink url="https://facebook.github.io/watchman/">watchman</ulink>
124 </para>
125
126 <para condition="html" role="usernotes">
127 Editor Notes: <ulink url="&blfs-wiki;/Thunderbird"/>
128 </para>
129 </sect2>
130
131 <sect2 role="installation">
132 <title>Installation of Thunderbird</title>
133
134 <note>
135 <para>
136 The build process for Thunderbird can use 8GB+ of RAM when linking.
137 Make sure that you have adequate swap or RAM before continuing.
138 </para>
139 </note>
140
141 <para>
142 The configuration of <application>Thunderbird</application> is
143 accomplished by creating a <filename>mozconfig</filename> file containing
144 the desired configuration options. A default
145 <filename>mozconfig</filename> is created below. To see the entire list
146 of available configuration options (and a brief description of each),
147 issue <command>./mach configure -- --help | less</command>. Create the file with
148 the following command:
149 </para>
150
151<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
152<literal># If you have a multicore machine, all cores will be used.
153
154# If you have installed wireless-tools comment out this line:
155ac_add_options --disable-necko-wifi
156
157# Uncomment the following option if you have not installed PulseAudio
158#ac_add_options --enable-audio-backends=alsa
159
160# Comment out following options if you have not installed
161# recommended dependencies:
162ac_add_options --with-system-libevent
163ac_add_options --with-system-libvpx
164ac_add_options --with-system-nspr
165ac_add_options --with-system-nss
166ac_add_options --with-system-icu
167
168# The elf-hack causes failed installs on some machines.
169# It is supposed to improve startup time and it shrinks libxul.so
170# by a few MB - comment this if you know your machine is not affected.
171ac_add_options --disable-elf-hack
172
173# The BLFS editors recommend not changing anything below this line:
174ac_add_options --prefix=/usr
175ac_add_options --enable-application=comm/mail
176
177ac_add_options --disable-crashreporter
178ac_add_options --disable-updater
179ac_add_options --disable-debug
180ac_add_options --disable-debug-symbols
181ac_add_options --disable-tests
182
183ac_add_options --enable-optimize=-O2
184ac_add_options --enable-linker=gold
185ac_add_options --enable-strip
186ac_add_options --enable-install-strip
187
188ac_add_options --enable-official-branding
189
190ac_add_options --enable-system-ffi
191ac_add_options --enable-system-pixman
192
193ac_add_options --with-system-jpeg
194ac_add_options --with-system-png
195ac_add_options --with-system-zlib
196
197# Using sandboxed wasm libraries has been moved to all builds instead
198# of only mozilla automation builds. It requires extra llvm packages
199# and was reported to seriously slow the build. Disable it.
200ac_add_options --without-wasm-sandboxed-libraries</literal>
201EOF</userinput></screen>
202<!-- Fixed in 102.9
203 <para>
204 A change in cbindgen-0.24.2 causes a symbol to now be output by
205 cbindgen, but it has already been defined in a header. This sed
206 prevents the build from eventually failing:
207 </para>
208
209<screen><userinput>sed -i '/ROOT_CLIP_CHAIN/d' gfx/webrender_bindings/webrender_ffi.h</userinput></screen>
210-->
211<!-- Not needed with clang
212 https://bugzilla.mozilla.org/show_bug.cgi?id=1729459
213 <para>
214 If building on a 32 bit machine, the following sed works around
215 an issue with an incompatible <quote>double</quote> type in one
216 header file:
217 </para>
218
219<screen><userinput>case "$(uname -m)" in
220 i?86) sed -e '/typedef[ ]*double/s/double/long double/' \
221 -i modules/fdlibm/src/math_private.h ;;
222esac</userinput></screen>
223-->
224
225 <para>
226 Fix an issue occurring when building with GCC-13:
227 </para>
228
229<screen><userinput>sed -e '/&lt;exception&gt;/i#include &lt;cstdint&gt;' \
230 -i comm/third_party/rnp/src/libsexp/include/sexp/sexp-error.h</userinput></screen>
231
232 <para>
233 Now invoke the Python <command>mach</command> script to compile
234 <application>Thunderbird</application>:
235 </para>
236
237 <note>
238 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
239 href="../../xincludes/mozshm.xml"/>
240
241 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
242 href="../../xincludes/mozmach.xml"/>
243
244 </note>
245
246<screen><userinput>export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none &amp;&amp;
247export MOZBUILD_STATE_PATH=./mozbuild &amp;&amp;
248./mach configure &amp;&amp;
249./mach build</userinput></screen>
250
251 <para>
252 This package does not come with a test suite.
253 </para>
254
255 <para>
256 Install <application>Thunderbird</application> by running the following
257 commands as the <systemitem class="username">root</systemitem> user:
258 </para>
259
260<screen role="root"><userinput>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none ./mach install</userinput></screen>
261<!-- devs: For DESTDIR install, prepend DESTDIR=<dest> to the above -->
262 <para>
263 Empty the environment variables which were set above:
264 </para>
265
266<screen><userinput>unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE MOZBUILD_STATE_PATH</userinput></screen>
267
268 </sect2>
269
270 <sect2 role="commands">
271 <title>Command Explanations</title>
272
273 <para>
274 <command>MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none</command>: Use the
275 system python to create a virtual environment for <command>mach</command>
276 without downloading any python wheels nor using the system python modules.
277 This prevent version mismatches between system modules and bundled ones.
278 </para>
279
280 <para>
281 <command>./mach configure</command>: This validates the supplied
282 dependencies and the <filename>mozconfig</filename>.
283 </para>
284
285 <para>
286 <option>./mach build --verbose</option>: Use this alternative if you
287 need details of which files are being compiled, together with any C or
288 C++ flags being used.
289 </para>
290
291 <para>
292 <option>./mach build -jN</option>: The build should, by default, use
293 all the online CPU cores. If using all the cores causes the build to swap
294 because you have insufficient memory, using fewer cores can be faster.
295 </para>
296
297 <para>
298 <option><envar>CC=gcc CXX=g++</envar></option>: BLFS used to
299 prefer to use gcc and g++ instead of upstream's defaults of the
300 <application>clang</application> programs. With the release of
301 gcc-12 the build takes longer with gcc and g++, primarily because
302 of extra warnings, and is bigger. Set these environment variables
303 <emphasis>before you run the configure script</emphasis>
304 if you wish to continue to use gcc, g++. Building
305 with GCC on i?86 is currently broken.
306 </para>
307
308 </sect2>
309
310 <sect2 role="configuration">
311 <title>Configuring Thunderbird</title>
312
313 <sect3><title>Configuration Information</title>
314
315 <para>
316 If your Window Manager or Desktop Environment does not allow you to
317 configure a default browser, you can add a configuration parameter to
318 <application>Thunderbird</application> so that a browser will start when
319 you click on an Internet/intranet/local URL. The procedure to check
320 or modify any of the configuration parameters is quite simple and the
321 instructions here can be used to view or modify any of the parameters.
322 </para>
323
324 <para>
325 First, open the configuration dialog by opening the <quote>Edit</quote>
326 drop-down menu. Choose <quote>Preferences</quote> and then scroll down
327 to the bottom of the page. Then, click the <quote>Config Editor</quote>
328 button. Click on the <quote>I accept the risk!</quote> button.
329 This will display a list of the configuration preferences and
330 information related to each one. You can use the <quote>Filter:</quote>
331 bar to enter search criteria and narrow down the listed items. Changing
332 a preference can be done using two methods. One, if the preference has a
333 boolean value (True/False), simply double-click on the preference to
334 toggle the value and two, for other preferences simply right-click on
335 the desired line, choose <quote>Modify</quote> from the menu and change
336 the value. Creating new preference items is accomplished in the same
337 way, except choose <quote>New</quote> from the menu and provide the
338 desired data into the fields when prompted.
339 </para>
340
341 <para>
342 The configuration preference item you need to check so that
343 <application>Thunderbird</application> uses a specified browser is the
344 <parameter>network.protocol-handler.app.http</parameter> which should be
345 set to the path of the desired browser, e.g.
346 <option>/usr/bin/firefox</option>.
347 </para>
348<!-- Bad URL
349 <tip>
350 <para>
351 There is a multitude of configuration parameters you can tweak to
352 customize <application>Thunderbird</application>. A very extensive,
353 but not so up-to-date list of these parameters can be found at
354 <ulink url="http://preferential.mozdev.org/preferences.html"/>.
355 </para>
356 </tip>
357-->
358 <para>
359
360 If you use a desktop environment such as <application>GNOME</application>
361 or <application>KDE</application>, a desktop file
362 <filename>thunderbird.desktop</filename> may be created, in order to
363 include a <quote><application>Thunderbird</application></quote> entry in
364 the menu. <!--If you didn't enable
365 <application>startup-notification</application> in your mozconfig, then
366 change the StartupNotify line to false.--> Run the following commands as the
367 <systemitem class="username">root</systemitem> user:
368
369 </para>
370
371<screen role="root"><userinput>mkdir -pv /usr/share/{applications,pixmaps} &amp;&amp;
372
373cat &gt; /usr/share/applications/thunderbird.desktop &lt;&lt; "EOF" &amp;&amp;
374<literal>[Desktop Entry]
375Name=Thunderbird Mail
376Comment=Send and receive mail with Thunderbird
377GenericName=Mail Client
378Exec=thunderbird %u
379Terminal=false
380Type=Application
381Icon=thunderbird
382Categories=Network;Email;
383MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
384StartupNotify=true</literal>
385EOF
386
387ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
388 /usr/share/pixmaps/thunderbird.png</userinput></screen>
389 </sect3>
390 </sect2>
391
392 <sect2 role="content">
393 <title>Contents</title>
394
395 <segmentedlist>
396 <segtitle>Installed Program</segtitle>
397 <segtitle>Installed Libraries</segtitle>
398 <segtitle>Installed Directory</segtitle>
399
400 <seglistitem>
401 <seg>
402 thunderbird
403 </seg>
404 <seg>
405 Numerous libraries and modules in the /usr/lib/thunderbird directory
406 </seg>
407 <seg>
408 /usr/lib/thunderbird
409 </seg>
410 </seglistitem>
411 </segmentedlist>
412
413 <variablelist>
414 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
415 <?dbfo list-presentation="list"?>
416 <?dbhtml list-presentation="table"?>
417
418 <varlistentry id="thunderbird-prog">
419 <term><command>thunderbird</command></term>
420 <listitem>
421 <para>
422 is <application>Mozilla</application>'s email and newsgroup client
423 </para>
424 <indexterm zone="thunderbird thunderbird-prog">
425 <primary sortas="b-thunderbird">thunderbird</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 </variablelist>
431
432 </sect2>
433
434</sect1>
Note: See TracBrowser for help on using the repository browser.