source: xsoft/graphweb/firefox.xml@ 9ff3be8

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gimp3 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 9ff3be8 was 9ff3be8, checked in by Ken Moffat <ken@…>, 8 years ago

Firefox-50.0.2

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