source: xsoft/graphweb/firefox.xml@ 57a8df2

10.0 10.1 11.0 11.1 11.2 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 57a8df2 was 57a8df2, checked in by Ken Moffat <ken@…>, 5 years ago

firefox-56.0.1

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

  • Property mode set to 100644
File size: 16.8 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 firefox-download-http "&mozilla-http;/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.xz">
8 <!ENTITY firefox-download-ftp " ">
9 <!ENTITY firefox-md5sum "1be2b13c37d70f4dd8564fbfef8e886b">
10 <!ENTITY firefox-size "243 MB">
11 <!ENTITY firefox-buildsize "6.3 GB (139 MB installed) without tests">
12 <!ENTITY firefox-time "18 SBU (with parallelism=4) without tests">
13]>
14
15<sect1 id="firefox" xreflabel="Firefox-&firefox-version;">
16 <?dbhtml filename="firefox.html" ?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Firefox-&firefox-version;</title>
24
25 <indexterm zone="firefox">
26 <primary sortas="a-Firefox">Firefox</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Firefox</title>
31
32 <para>
33 <application>Firefox</application> is a stand-alone browser based on the
34 <application>Mozilla</application> codebase.
35 </para>
36
37 &lfs81_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&firefox-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&firefox-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &firefox-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &firefox-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &firefox-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &firefox-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
74 <itemizedlist spacing="compact">
75 <listitem>
76 <para>
77 Optional patch to allow system versions of <xref linkend="graphite2"/>
78 and <xref linkend="harfbuzz"/>
79 <ulink url="&patch-root;/firefox-&firefox-version;-system_graphite2_harfbuzz-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>
83
84 <note>
85 <para>
86 The tarball <emphasis>firefox-&firefox-version;.source.tar.xz</emphasis>
87 will untar to <emphasis>firefox-&firefox-version;</emphasis> directory.
88 It will also reset the permissions of the current directory to 0755 if you
89 have permission to do that. If you do this in a directory where
90 the sticky bit is set, such
91 as <filename class="directory">/tmp</filename> it will end with error
92 messages:
93 </para>
94
95<literallayout>tar: .: Cannot utime: Operation not permitted
96tar: .: Cannot change mode to rwxr-xr-t: Operation not permitted
97tar: Exiting with failure status due to previous errors
98</literallayout>
99
100 <para>
101 This does finish with non-zero status, but it does
102 <emphasis>NOT</emphasis> mean there is a real problem.
103 Do not untar as the <systemitem class="username">root</systemitem> user
104 in a directory where the sticky bit is set - that will unset it.
105 </para>
106 </note>
107
108 <bridgehead renderas="sect3">Firefox Dependencies</bridgehead>
109
110 <bridgehead renderas="sect4">Required</bridgehead>
111 <para role="required">
112 <xref linkend="autoconf213"/>,
113 both <xref linkend="gtk3"/> and
114 <xref linkend="gtk2"/>,
115 <xref linkend="nss"/>,
116 <xref linkend="pulseaudio"/>
117 (or
118 <xref linkend="alsa-lib"/> if you edit the mozconfig;
119 now deprecated by mozilla),
120 <xref linkend="rust"/>,
121 <xref linkend="unzip"/>,
122 <xref linkend="yasm"/>, and
123 <xref linkend="zip"/>
124 </para>
125
126 <note>
127 <para>
128 The firefox developers wish to enable Stylo (replacement code to handle
129 Cascading Style Sheets) by default. At the moment that code cannot build
130 with system versions of nspr and pixman (it fails to find their headers)
131 so the BLFS editors have chosen to disable it. If you choose to enable
132 it, you <emphasis>must</emphasis> add <package>clang</package> from
133 <xref linkend="llvm"/> to the Required dependencies.
134 </para>
135 </note>
136
137 <bridgehead renderas="sect4">Recommended</bridgehead>
138 <para role="recommended">
139 <xref linkend="icu"/>,
140 <xref linkend="libevent"/>,
141 <xref linkend="libvpx"/>, and
142 <xref linkend="sqlite"/>
143 </para>
144
145 <note>
146 <para>
147 If you don't install recommended dependencies, then internal copies of
148 those packages will be used. They might be tested to work, but they can
149 be out of date or contain security holes.
150 </para>
151 </note>
152
153 <note>
154 <para>
155 With <application>Firefox-31.0</application> and later versions, you
156 must have installed <application>Openssl</application> before
157 <application>Python 2</application> or the build system will quickly
158 fail with output including "ImportError: cannot import name
159 HTTPSHandler". If you are in any doubt about this (e.g. upgrading from
160 an older version of Firefox), check if
161 <filename>/usr/lib/python&python2-majorver;/lib-dynload/_ssl.so</filename>
162 exists. If it does not, reinstall <xref linkend="python2"/> (after
163 installing <xref linkend="openssl"/>). The latest version of any
164 <emphasis>currently maintained</emphasis> version of Openssl should be
165 satisfactory if already installed.
166 </para>
167 </note>
168
169 <bridgehead renderas="sect4">Optional</bridgehead>
170 <para role="optional">
171 <xref linkend="curl"/>,
172 <xref linkend="dbus-glib"/>,
173 <xref linkend="doxygen"/>,
174 <xref linkend="GConf"/>,
175 <xref role="runtime" linkend="ffmpeg"/> (runtime, to play mov, mp3 or mp4 files),
176 <xref linkend="libwebp"/>,
177 <xref linkend="openjdk"/>,
178 <xref linkend="startup-notification"/>,
179 <xref linkend="valgrind"/>,
180 <xref linkend="wget"/>,
181 <xref linkend="wireless_tools"/>,
182 <ulink url="https://hunspell.github.io/">Hunspell</ulink>,
183 <phrase revision="sysv"><ulink url="http://sourceforge.net/projects/liboauth/files/">liboauth</ulink></phrase>
184 <phrase revision="systemd"><xref linkend="liboauth"/></phrase>,
185 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>,
186 and (with the patch)
187 <xref linkend="graphite2"/> and
188 <xref linkend="harfbuzz"/>
189 </para>
190
191 <para condition="html" role="usernotes">
192 User Notes: <ulink url="&blfs-wiki;/firefox"/>
193 </para>
194 </sect2>
195
196 <sect2 role="installation">
197 <title>Installation of Firefox</title>
198
199 <para>
200 The configuration of <application>Firefox</application> is accomplished
201 by creating a <filename>mozconfig</filename> file containing the desired
202 configuration options. A default <filename>mozconfig</filename> is
203 created below. To see the entire list of available configuration options
204 (and an abbreviated description of each one), issue <command>./configure
205 --help</command>. You may also wish to review the entire file and
206 uncomment any other desired options. Create the file by issuing the
207 following command:
208 </para>
209
210<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
211<literal># If you have a multicore machine, all cores will be used by default.
212# If desired, you can reduce the number of cores used, e.g. to 1, by
213# uncommenting the next line and setting a valid number of CPU cores.
214#mk_add_options MOZ_MAKE_FLAGS="-j1"
215
216# If you have installed dbus-glib, comment out this line:
217ac_add_options --disable-dbus
218
219# If you have installed dbus-glib, and you have installed (or will install)
220# wireless-tools, and you wish to use geolocation web services, comment out
221# this line
222ac_add_options --disable-necko-wifi
223
224# API Keys for geolocation APIs - necko-wifi (above) is required for MLS
225# Uncomment the following line if you wish to use Mozilla Location Service
226#ac_add_options --with-mozilla-api-keyfile=$PWD/mozilla-key
227
228# Uncomment the following line if you wish to use Google's geolocaton API
229# (needed for use with saved maps with Google Maps)
230#ac_add_options --with-google-api-keyfile=$PWD/google-key
231
232# Uncomment these lines if you have installed optional dependencies:
233#ac_add_options --enable-system-hunspell
234#ac_add_options --enable-startup-notification
235
236# Uncomment the following option if you have not installed PulseAudio
237#ac_add_options --disable-pulseaudio
238# and uncomment this if you installed alsa-lib instead of PulseAudio
239#ac_add_options --enable-alsa
240
241# If you have installed GConf, comment out this line
242ac_add_options --disable-gconf
243
244# Stylo is the new CSS code, including the rust 'style'
245# package. It is enabled by default, but cannot find the
246# headers for system nspr, pixman. If you enable stylo you
247# must comment out system-nspr system-pixman and
248# system-cairo, and you must also have installed clang.
249ac_add_options --disable-stylo
250
251# Comment out following options if you have not installed
252# recommended dependencies:
253ac_add_options --enable-system-sqlite
254ac_add_options --with-system-libevent
255ac_add_options --with-system-libvpx
256ac_add_options --with-system-nspr
257ac_add_options --with-system-nss
258ac_add_options --with-system-icu
259
260# If you are going to apply the patch for system graphite
261# and system harfbuzz, uncomment these lines:
262#ac_add_options --with-system-graphite2
263#ac_add_options --with-system-harfbuzz
264
265# Stripping is now enabled by default.
266# Uncomment these lines if you need to run a debugger:
267#ac_add_options --disable-strip
268#ac_add_options --disable-install-strip
269
270# The BLFS editors recommend not changing anything below this line:
271ac_add_options --prefix=/usr
272ac_add_options --enable-application=browser
273
274ac_add_options --disable-crashreporter
275ac_add_options --disable-updater
276# enabling the tests will use a lot more space and significantly
277# increase the build time, for no obvious benefit.
278ac_add_options --disable-tests
279
280# Optimization for size is broken with gcc7
281ac_add_options --enable-optimize="-O2"
282
283ac_add_options --enable-official-branding
284ac_add_options --enable-safe-browsing
285ac_add_options --enable-url-classifier
286
287# From firefox-40, using system cairo caused firefox to crash
288# frequently when it was doing background rendering in a tab.
289# This appears to again work in firefox-56
290ac_add_options --enable-system-cairo
291ac_add_options --enable-system-ffi
292ac_add_options --enable-system-pixman
293
294ac_add_options --with-pthreads
295
296ac_add_options --with-system-bz2
297ac_add_options --with-system-jpeg
298ac_add_options --with-system-png
299ac_add_options --with-system-zlib
300
301mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir</literal>
302EOF</userinput></screen>
303
304 <para>
305 Compile <application>Firefox</application> by issuing the following
306 commands:
307 </para>
308
309 <para>
310 If you have installed system versions of graphite2 and harfbuzz and wish
311 firefox to use those instead of its shipped versions, apply the patch and
312 uncomment the appropriate entries in the <filename>mozconfig</filename>
313 file. This also ensures that the system versions linked by
314 <filename>libmozgtk.so</filename> match those used in
315 <filename>libxul.so</filename>:
316 </para>
317
318<screen><userinput>patch -Np1 -i ../firefox-&firefox-version;-system_graphite2_harfbuzz-1.patch</userinput></screen>
319
320 <para>
321 If the geolocation APIs are needed:
322 </para>
323
324<screen><userinput>echo "AIzaSyDxKL42zsPjbke5O8_rPVpVrLrJ8aeE9rQ" > google-key
325echo "d2284a20-0505-4927-a809-7ffaf4d91e55" > mozilla-key</userinput></screen>
326
327 <note><para>
328 If you are compiling <application>Firefox</application> in chroot, make
329 sure you have <envar>$SHELL</envar> environment variable set or prepend
330 <envar>SHELL=/bin/sh</envar>.
331 </para></note>
332
333<screen><userinput>make -f client.mk</userinput></screen>
334
335 <para>
336 The <filename>mozconfig</filename> above disables the tests because
337 they use a lot more time and disk space for no obvious benefit. If
338 you have nevertheless enabled them, you can run the tests by executing:
339 </para>
340
341<screen><userinput>./mach gtest</userinput></screen>
342
343 <para>
344 This will require a network connection, and to be run from within an
345 Xorg session - there is a popup dialog when it fails to connect to
346 ALSA (that does not create a failed test). One or two tests will fail.
347 To see the details of the failure(s) you will need to log the output
348 from that command so that you can review it.
349 </para>
350
351 <para>
352 Now, as the <systemitem class="username">root</systemitem> user:
353 </para>
354
355<screen role="root"><userinput>make -f client.mk install INSTALL_SDK= &amp;&amp;
356chown -R 0:0 /usr/lib/firefox-&firefox-version; &amp;&amp;
357
358mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
359ln -sfv ../../mozilla/plugins /usr/lib/firefox-&firefox-version;/browser</userinput></screen>
360<!--
361 <para>
362 Set environment variables back to their values:
363 </para>
364
365<screen><userinput>export CFLAGS=$CFLAGS_HOLD &amp;&amp;
366export CXXFLAGS=$CXXFLAGS_HOLD &amp;&amp;
367unset CFLAGS_HOLD CXXFLAGS_HOLD</userinput></screen>
368-->
369
370 </sect2>
371
372 <sect2 role="commands">
373 <title>Command Explanations</title>
374
375 <para>
376 <command>make -f client.mk ...</command>: Mozilla products are packaged to
377 allow the use of a configuration file which can be used to pass the
378 configuration settings to the <command>configure</command> command.
379 <command>make</command> uses the <filename>client.mk</filename> file to
380 get initial configuration and setup parameters.
381 </para>
382
383 <para>
384 <command>mkdir -p /usr/lib/mozilla/plugins</command>: This checks
385 that <filename class="directory">/usr/lib/mozilla/plugins</filename>
386 exists.
387 </para>
388
389 <para>
390 <command>ln -sv ... /usr/lib/firefox-&firefox-version;/browser</command>:
391 This command creates a symbolic link to <filename
392 class="directory">/usr/lib/mozilla/plugins</filename>. It's not really
393 needed, as <application>Firefox</application> checks <filename
394 class="directory">/usr/lib/mozilla/plugins</filename> by default, but the
395 symbolic link is made to keep all the plugins installed in one folder.
396 </para>
397
398 </sect2>
399
400 <sect2 role="configuration">
401 <title>Configuring Firefox</title>
402
403 <para>
404 If you use a desktop environment like <application>Gnome</application> or
405 <application>KDE</application> you may like to create a
406 <filename>firefox.desktop</filename> file so that
407 <application>Firefox</application> appears in the panel's menus. If you
408 didn't enable startup-notification in your mozconfig change the
409 StartupNotify line to false. As the
410 <systemitem class="username">root</systemitem> user:
411 </para>
412
413<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
414mkdir -pv /usr/share/pixmaps &amp;&amp;
415
416cat &gt; /usr/share/applications/firefox.desktop &lt;&lt; "EOF" &amp;&amp;
417<literal>[Desktop Entry]
418Encoding=UTF-8
419Name=Firefox Web Browser
420Comment=Browse the World Wide Web
421GenericName=Web Browser
422Exec=firefox %u
423Terminal=false
424Type=Application
425Icon=firefox
426Categories=GNOME;GTK;Network;WebBrowser;
427MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
428StartupNotify=true</literal>
429EOF
430
431ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \
432 /usr/share/pixmaps/firefox.png</userinput></screen>
433
434 </sect2>
435
436 <sect2 role="content">
437 <title>Contents</title>
438
439 <segmentedlist>
440 <segtitle>Installed Programs</segtitle>
441 <segtitle>Installed Libraries</segtitle>
442 <segtitle>Installed Directory</segtitle>
443
444 <seglistitem>
445 <seg>
446 firefox
447 </seg>
448 <seg>
449 Numerous libraries, browser components, plugins, extensions, and
450 helper modules installed in /usr/lib/firefox-&firefox-version;
451 </seg>
452 <seg>
453 /usr/lib/firefox-&firefox-version; and /usr/lib/mozilla
454 </seg>
455 </seglistitem>
456 </segmentedlist>
457
458 <variablelist>
459 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
460 <?dbfo list-presentation="list"?>
461 <?dbhtml list-presentation="table"?>
462
463 <varlistentry id="firefox-prog">
464 <term><command>firefox</command></term>
465 <listitem>
466 <para>
467 is a <application>GTK+-3</application> internet browser that uses
468 the Mozilla Gecko rendering engine.
469 </para>
470 <indexterm zone="firefox firefox-prog">
471 <primary sortas="b-firefox">firefox</primary>
472 </indexterm>
473 </listitem>
474 </varlistentry>
475
476 </variablelist>
477
478 </sect2>
479
480</sect1>
Note: See TracBrowser for help on using the repository browser.