source: xsoft/other/thunderbird.xml@ 47f6041

12.0 12.1 12.2 gimp3 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new 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 47f6041 was 7b0eaab, checked in by Pierre Labastie <pierre.labastie@…>, 18 months ago

thunderbird: remove the sed for ROOT_CLIP_CHAIN

It is now upstream.
Also remove a duplicated sentence

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