source: xsoft/graphweb/firefox.xml@ 81b3e7fd

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

firefox-52.0

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

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