source: xsoft/graphweb/firefox.xml@ a980725

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a980725 was a980725, checked in by Igor Živković <igor@…>, 6 years ago

Update to firefox-46.0.
Update to libgpg-error-1.22.

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

  • Property mode set to 100644
File size: 13.6 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<!-- 550 Permission denied.
9 <!ENTITY firefox-download-ftp "&mozilla-ftp;/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2"> -->
10 <!ENTITY firefox-download-ftp " ">
11 <!ENTITY firefox-md5sum "8a516da3858b17f55451810efc7a239a">
12 <!ENTITY firefox-size "179 MB">
13 <!ENTITY firefox-buildsize "4.4 GB (80 MB installed)">
14 <!ENTITY firefox-time "11 SBU (with parallelism=4)">
15]>
16
17<sect1 id="firefox" xreflabel="Firefox-&firefox-version;">
18 <?dbhtml filename="firefox.html" ?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Firefox-&firefox-version;</title>
26
27 <indexterm zone="firefox">
28 <primary sortas="a-Firefox">Firefox</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Firefox</title>
33
34 <para>
35 <application>Firefox</application> is a stand-alone browser based on the
36 <application>Mozilla</application> codebase.
37 </para>
38
39 &lfs79_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&firefox-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&firefox-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &firefox-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &firefox-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &firefox-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &firefox-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <note>
76 <para>
77 The tarball <emphasis>firefox-&firefox-version;.source.tar.xz</emphasis>
78 will untar to <emphasis>firefox-&firefox-version;</emphasis> directory.
79 </para>
80 </note>
81
82 <bridgehead renderas="sect3">Firefox Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="alsa-lib"/>,
87 <xref linkend="gtk2"/>
88 (or <xref linkend="gtk3"/> if you change the mozconfig where indicated),
89 <xref linkend="nss"/>,
90 <xref linkend="unzip"/>,
91 <xref linkend="yasm"/>, and
92 <xref linkend="zip"/>
93 </para>
94
95 <bridgehead renderas="sect4">Recommended</bridgehead>
96 <para role="recommended">
97 <xref linkend="icu"/>,
98 <xref linkend="libevent"/>,
99 <xref linkend="libvpx"/>, and
100 <xref linkend="sqlite"/>
101 </para>
102
103 <note>
104 <para>
105 If you don't install recommended dependencies, then internal copies of
106 those packages will be used. They might be tested to work, but they can
107 be out of date or contain security holes.
108 </para>
109 </note>
110
111 <note>
112 <para>
113 With <application>Firefox-31.0</application> and later versions, you
114 must have installed <application>Openssl</application> before
115 <application>Python 2</application> or the build system will quickly
116 fail with output including "ImportError: cannot import name
117 HTTPSHandler". If you are in any doubt about this (e.g. upgrading from
118 an older version of Firefox), check if
119 <filename>/usr/lib/python&python2-majorver;/lib-dynload/_ssl.so</filename>
120 exists. If it does not, reinstall <xref linkend="python2"/> (after
121 installing <xref linkend="openssl"/>). The latest version of any
122 <emphasis>currently maintained</emphasis> version of Openssl should be
123 satisfactory if already installed.
124 </para>
125 </note>
126
127 <bridgehead renderas="sect4">Optional</bridgehead>
128 <para role="optional">
129 <xref linkend="curl"/>,
130 <xref linkend="dbus-glib"/>,
131 <xref linkend="doxygen"/>,
132 <xref linkend="GConf"/>,
133 <xref linkend="ffmpeg"/> (runtime) or
134 <xref linkend="gst10-plugins-base"/> (with
135 <xref linkend="gst10-plugins-good"/> and
136 <xref linkend="gst10-libav"/> at runtime),
137 <xref linkend="libwebp"/>,
138 <xref linkend="openjdk"/>,
139 <xref linkend="pulseaudio"/>,
140 <xref linkend="startup-notification"/>,
141 <xref linkend="valgrind"/>,
142 <xref linkend="wget"/>,
143 <xref linkend="wireless_tools"/>,
144 <ulink url="https://hunspell.github.io/">Hunspell</ulink>,
145 <ulink url="http://sourceforge.net/projects/liboauth/files/">liboauth</ulink>, and
146 <ulink url="https://github.com/libproxy/libproxy">libproxy</ulink>, and
147 <ulink url="https://www.rust-lang.org/">Rust</ulink>
148 </para>
149
150 <para condition="html" role="usernotes">
151 User Notes: <ulink url="&blfs-wiki;/firefox"/>
152 </para>
153 </sect2>
154
155 <sect2 role="installation">
156 <title>Installation of Firefox</title>
157
158 <para>
159 The configuration of <application>Firefox</application> is accomplished
160 by creating a <filename>mozconfig</filename> file containing the desired
161 configuration options. A default <filename>mozconfig</filename> is
162 created below. To see the entire list of available configuration options
163 (and an abbreviated description of each one), issue <command>./configure
164 --help</command>. You may also wish to review the entire file and
165 uncomment any other desired options. Create the file by issuing the
166 following command:
167 </para>
168
169<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
170<literal># If you have a multicore machine, all cores will be used by default.
171# If desired, you can reduce the number of cores used, e.g. to 1, by
172# uncommenting the next line and setting a valid number of CPU cores.
173#mk_add_options MOZ_MAKE_FLAGS="-j1"
174
175# If you have installed DBus-Glib comment out this line:
176ac_add_options --disable-dbus
177
178# If you have installed dbus-glib, and you have installed (or will install)
179# wireless-tools, and you wish to use geolocation web services, comment out
180# this line
181ac_add_options --disable-necko-wifi
182
183# GStreamer is necessary for H.264 video playback in HTML5 Video Player if
184# FFmpeg is not found at runtime;
185# to be enabled, also remember to set "media.gstreamer.enabled" to "true"
186# in about:config. If you have GStreamer 1.x.y, comment out this line and
187# uncomment the following one:
188ac_add_options --disable-gstreamer
189#ac_add_options --enable-gstreamer=1.0
190
191# Comment out this option if you wish to build with gtk+-3
192ac_add_options --enable-default-toolkit=cairo-gtk2
193
194# Uncomment these lines if you have installed optional dependencies:
195#ac_add_options --enable-system-hunspell
196#ac_add_options --enable-startup-notification
197
198# Comment out following option if you have PulseAudio installed
199ac_add_options --disable-pulseaudio
200
201# If you have installed GConf, comment out this line
202ac_add_options --disable-gconf
203
204# Comment out following options if you have not installed
205# recommended dependencies:
206ac_add_options --enable-system-sqlite
207ac_add_options --with-system-libevent
208ac_add_options --with-system-libvpx
209ac_add_options --with-system-nspr
210ac_add_options --with-system-nss
211ac_add_options --with-system-icu
212
213# The BLFS editors recommend not changing anything below this line:
214ac_add_options --prefix=/usr
215ac_add_options --enable-application=browser
216
217ac_add_options --disable-crashreporter
218ac_add_options --disable-updater
219ac_add_options --disable-tests
220
221ac_add_options --enable-optimize
222ac_add_options --enable-strip
223ac_add_options --enable-install-strip
224
225ac_add_options --enable-gio
226ac_add_options --enable-official-branding
227ac_add_options --enable-safe-browsing
228ac_add_options --enable-url-classifier
229
230# From firefox-40, using system cairo causes firefox to crash
231# frequently when it is doing background rendering in a tab.
232#ac_add_options --enable-system-cairo
233ac_add_options --enable-system-ffi
234ac_add_options --enable-system-pixman
235
236ac_add_options --with-pthreads
237
238ac_add_options --with-system-bz2
239ac_add_options --with-system-jpeg
240ac_add_options --with-system-png
241ac_add_options --with-system-zlib
242
243mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir</literal>
244EOF</userinput></screen>
245
246 <para>
247 Compile <application>Firefox</application> by issuing the following
248 commands:
249 </para>
250
251 <note><para>
252 If you are compiling <application>Firefox</application> in chroot, make
253 sure you have <envar>$SHELL</envar> environment variable set or prepend
254 <envar>SHELL=/bin/sh</envar>.
255 </para></note>
256
257<screen><userinput>make -f client.mk</userinput></screen>
258
259 <para>
260 This package does not come with a test suite.
261 </para>
262
263 <para>
264 Now, as the <systemitem class="username">root</systemitem> user:
265 </para>
266
267<screen role="root"><userinput>make -f client.mk install INSTALL_SDK= &amp;&amp;
268chown -R 0:0 /usr/lib/firefox-&firefox-version; &amp;&amp;
269
270mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
271ln -sfv ../../mozilla/plugins /usr/lib/firefox-&firefox-version;/browser</userinput></screen>
272
273 </sect2>
274
275 <sect2 role="commands">
276 <title>Command Explanations</title>
277
278 <para>
279 <command>make -f client.mk ...</command>: Mozilla products are packaged to
280 allow the use of a configuration file which can be used to pass the
281 configuration settings to the <command>configure</command> command.
282 <command>make</command> uses the <filename>client.mk</filename> file to
283 get initial configuration and setup parameters.
284 </para>
285
286 <para>
287 <command>make -C firefox-build-dir install</command>: This runs
288 <command>make install</command> in firefox-build-dir.
289 </para>
290
291 <para>
292 <command>ln -sfv ... /usr/bin/firefox</command>: This puts a symbolic link
293 to the <command>firefox</command> executable in your <envar>PATH</envar>
294 variable.
295 </para>
296
297 <para>
298 <command>mkdir -p /usr/lib/mozilla/plugins</command>: This checks
299 that <filename class="directory">/usr/lib/mozilla/plugins</filename>
300 exists.
301 </para>
302
303 <para>
304 <command>ln -sv ... /usr/lib/firefox-&firefox-version;/browser</command>:
305 This command creates a symbolic link to <filename
306 class="directory">/usr/lib/mozilla/plugins</filename>. It's not really
307 needed, as <application>Firefox</application> checks <filename
308 class="directory">/usr/lib/mozilla/plugins</filename> by default, but the
309 symbolic link is made to keep all the plugins installed in one folder.
310 </para>
311
312 </sect2>
313
314 <sect2 role="configuration">
315 <title>Configuring Firefox</title>
316
317 <para>
318 If you did not add the <option>--disable-webm</option> option to your
319 <filename>mozconfig</filename>, your <application>Firefox</application>
320 can play most YouTube videos without the need for the flash plugin. To
321 enable this, go to <ulink url="http://www.youtube.com/html5"/> and click
322 on 'Join the HTML5 Trial' (needs cookies enabled).
323 </para>
324
325 <para>
326 If you use a desktop environment like <application>Gnome</application> or
327 <application>KDE</application> you may like to create a
328 <filename>firefox.desktop</filename> file so that
329 <application>Firefox</application> appears in the panel's menus. If you
330 didn't enable startup-notification in your mozconfig change the
331 StartupNotify line to false. As the
332 <systemitem class="username">root</systemitem> user:
333 </para>
334
335<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
336mkdir -pv /usr/share/pixmaps &amp;&amp;
337
338cat &gt; /usr/share/applications/firefox.desktop &lt;&lt; "EOF" &amp;&amp;
339<literal>[Desktop Entry]
340Encoding=UTF-8
341Name=Firefox Web Browser
342Comment=Browse the World Wide Web
343GenericName=Web Browser
344Exec=firefox %u
345Terminal=false
346Type=Application
347Icon=firefox
348Categories=GNOME;GTK;Network;WebBrowser;
349MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
350StartupNotify=true</literal>
351EOF
352
353ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \
354 /usr/share/pixmaps/firefox.png</userinput></screen>
355
356 </sect2>
357
358 <sect2 role="content">
359 <title>Contents</title>
360
361 <segmentedlist>
362 <segtitle>Installed Programs</segtitle>
363 <segtitle>Installed Libraries</segtitle>
364 <segtitle>Installed Directory</segtitle>
365
366 <seglistitem>
367 <seg>
368 firefox
369 </seg>
370 <seg>
371 Numerous libraries, browser components, plugins, extensions, and
372 helper modules installed in /usr/lib/firefox-&firefox-version;
373 </seg>
374 <seg>
375 /usr/lib/firefox-&firefox-version;
376 </seg>
377 </seglistitem>
378 </segmentedlist>
379
380 <variablelist>
381 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
382 <?dbfo list-presentation="list"?>
383 <?dbhtml list-presentation="table"?>
384
385 <varlistentry id="firefox-prog">
386 <term><command>firefox</command></term>
387 <listitem>
388 <para>
389 is a <application>GTK+ 2</application> internet browser that uses the
390 Mozilla Gecko rendering engine.
391 </para>
392 <indexterm zone="firefox firefox-prog">
393 <primary sortas="b-firefox">firefox</primary>
394 </indexterm>
395 </listitem>
396 </varlistentry>
397
398 </variablelist>
399
400 </sect2>
401
402</sect1>
Note: See TracBrowser for help on using the repository browser.