source: xsoft/graphweb/firefox.xml@ 0c3e9be8

10.0 10.1 11.0 7.10 7.7 7.8 7.9 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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 0c3e9be8 was 0c3e9be8, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Add keybinder2-0.3.0.
Update to lxpanel-0.8.0.
xfce4-mixer-4.10.0: uncomment keybinder and replace broken ulink by xref.
Python-2.7.8, SeaMonkey-2.31, Firefox-34.0. and Thunderbird-31.3.0:

replace /usr/lib/python2.7 by /usr/lib/python&python2-majorver;.

libxklavier-5.3: typo.

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

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