source: xsoft/graphweb/firefox.xml@ 6000a3e

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 krejzi/svn lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6000a3e was 6000a3e, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

SeaMonkey-2.30 and Thunderbird-31.2.0: add GStreamer 1.x.y dependency and in mozconfig.
Firefox-33.0: reorder optional dependencies.
Update to libxml2-2.9.2.

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