source: xsoft/graphweb/firefox.xml@ 5f9e42c9

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 5f9e42c9 was 5f9e42c9, checked in by Ken Moffat <ken@…>, 5 years ago

Firefox - a build where stylo is enabled showed that enabling system-cairo causes style to fail to build, looking for pixman.h.

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

  • Property mode set to 100644
File size: 16.1 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 "d1615a5d49f488bc8c48771669c29542">
10 <!ENTITY firefox-size "244 MB">
11 <!ENTITY firefox-buildsize "6.2 GB (139 MB installed)">
12 <!ENTITY firefox-time "18 SBU (with parallelism=4)">
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
276ac_add_options --disable-tests
277
278# Optimization for size is broken with gcc7
279ac_add_options --enable-optimize="-O2"
280
281ac_add_options --enable-official-branding
282ac_add_options --enable-safe-browsing
283ac_add_options --enable-url-classifier
284
285# From firefox-40, using system cairo caused firefox to crash
286# frequently when it was doing background rendering in a tab.
287# This appears to again work in firefox-56
288ac_add_options --enable-system-cairo
289ac_add_options --enable-system-ffi
290ac_add_options --enable-system-pixman
291
292ac_add_options --with-pthreads
293
294ac_add_options --with-system-bz2
295ac_add_options --with-system-jpeg
296ac_add_options --with-system-png
297ac_add_options --with-system-zlib
298
299mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir</literal>
300EOF</userinput></screen>
301
302 <para>
303 Compile <application>Firefox</application> by issuing the following
304 commands:
305 </para>
306
307 <para>
308 If you have installed system versions of graphite2 and harfbuzz and wish
309 firefox to use those instead of its shipped versions, apply the patch and
310 uncomment the appropriate entries in the <filename>mozconfig</filename>
311 file. This also ensures that the system versions linked by
312 <filename>libmozgtk.so</filename> match those used in
313 <filename>libxul.so</filename>:
314 </para>
315
316<screen><userinput>patch -Np1 -i ../firefox-&firefox-version;-system_graphite2_harfbuzz-1.patch</userinput></screen>
317
318 <para>
319 If the geolocation APIs are needed:
320 </para>
321
322<screen><userinput>echo "AIzaSyDxKL42zsPjbke5O8_rPVpVrLrJ8aeE9rQ" > google-key
323echo "d2284a20-0505-4927-a809-7ffaf4d91e55" > mozilla-key</userinput></screen>
324
325 <note><para>
326 If you are compiling <application>Firefox</application> in chroot, make
327 sure you have <envar>$SHELL</envar> environment variable set or prepend
328 <envar>SHELL=/bin/sh</envar>.
329 </para></note>
330
331<screen><userinput>make -f client.mk</userinput></screen>
332
333 <para>
334 This package does not come with a test suite.
335 </para>
336
337 <para>
338 Now, as the <systemitem class="username">root</systemitem> user:
339 </para>
340
341<screen role="root"><userinput>make -f client.mk install INSTALL_SDK= &amp;&amp;
342chown -R 0:0 /usr/lib/firefox-&firefox-version; &amp;&amp;
343
344mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
345ln -sfv ../../mozilla/plugins /usr/lib/firefox-&firefox-version;/browser</userinput></screen>
346<!--
347 <para>
348 Set environment variables back to their values:
349 </para>
350
351<screen><userinput>export CFLAGS=$CFLAGS_HOLD &amp;&amp;
352export CXXFLAGS=$CXXFLAGS_HOLD &amp;&amp;
353unset CFLAGS_HOLD CXXFLAGS_HOLD</userinput></screen>
354-->
355
356 </sect2>
357
358 <sect2 role="commands">
359 <title>Command Explanations</title>
360
361 <para>
362 <command>make -f client.mk ...</command>: Mozilla products are packaged to
363 allow the use of a configuration file which can be used to pass the
364 configuration settings to the <command>configure</command> command.
365 <command>make</command> uses the <filename>client.mk</filename> file to
366 get initial configuration and setup parameters.
367 </para>
368
369 <para>
370 <command>mkdir -p /usr/lib/mozilla/plugins</command>: This checks
371 that <filename class="directory">/usr/lib/mozilla/plugins</filename>
372 exists.
373 </para>
374
375 <para>
376 <command>ln -sv ... /usr/lib/firefox-&firefox-version;/browser</command>:
377 This command creates a symbolic link to <filename
378 class="directory">/usr/lib/mozilla/plugins</filename>. It's not really
379 needed, as <application>Firefox</application> checks <filename
380 class="directory">/usr/lib/mozilla/plugins</filename> by default, but the
381 symbolic link is made to keep all the plugins installed in one folder.
382 </para>
383
384 </sect2>
385
386 <sect2 role="configuration">
387 <title>Configuring Firefox</title>
388
389 <para>
390 If you use a desktop environment like <application>Gnome</application> or
391 <application>KDE</application> you may like to create a
392 <filename>firefox.desktop</filename> file so that
393 <application>Firefox</application> appears in the panel's menus. If you
394 didn't enable startup-notification in your mozconfig change the
395 StartupNotify line to false. As the
396 <systemitem class="username">root</systemitem> user:
397 </para>
398
399<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
400mkdir -pv /usr/share/pixmaps &amp;&amp;
401
402cat &gt; /usr/share/applications/firefox.desktop &lt;&lt; "EOF" &amp;&amp;
403<literal>[Desktop Entry]
404Encoding=UTF-8
405Name=Firefox Web Browser
406Comment=Browse the World Wide Web
407GenericName=Web Browser
408Exec=firefox %u
409Terminal=false
410Type=Application
411Icon=firefox
412Categories=GNOME;GTK;Network;WebBrowser;
413MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
414StartupNotify=true</literal>
415EOF
416
417ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \
418 /usr/share/pixmaps/firefox.png</userinput></screen>
419
420 </sect2>
421
422 <sect2 role="content">
423 <title>Contents</title>
424
425 <segmentedlist>
426 <segtitle>Installed Programs</segtitle>
427 <segtitle>Installed Libraries</segtitle>
428 <segtitle>Installed Directory</segtitle>
429
430 <seglistitem>
431 <seg>
432 firefox
433 </seg>
434 <seg>
435 Numerous libraries, browser components, plugins, extensions, and
436 helper modules installed in /usr/lib/firefox-&firefox-version;
437 </seg>
438 <seg>
439 /usr/lib/firefox-&firefox-version; and /usr/lib/mozilla
440 </seg>
441 </seglistitem>
442 </segmentedlist>
443
444 <variablelist>
445 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
446 <?dbfo list-presentation="list"?>
447 <?dbhtml list-presentation="table"?>
448
449 <varlistentry id="firefox-prog">
450 <term><command>firefox</command></term>
451 <listitem>
452 <para>
453 is a <application>GTK+-3</application> internet browser that uses
454 the Mozilla Gecko rendering engine.
455 </para>
456 <indexterm zone="firefox firefox-prog">
457 <primary sortas="b-firefox">firefox</primary>
458 </indexterm>
459 </listitem>
460 </varlistentry>
461
462 </variablelist>
463
464 </sect2>
465
466</sect1>
Note: See TracBrowser for help on using the repository browser.