source: xsoft/graphweb/firefox.xml@ d6c6562

10.0 10.1 11.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since d6c6562 was d6c6562, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Remove gcc7 entity

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