source: xsoft/graphweb/firefox.xml@ ad5a97d

10.0 10.1 11.0 11.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since ad5a97d was ad5a97d, checked in by DJ Lucas <dj@…>, 5 years ago

Update to Firefox-53.0.3. Fixes #9261.
Add geolocation APIs to Firefox.

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

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