source: xsoft/graphweb/firefox.xml@ 13d0d6f

10.0 10.1 11.0 7.10 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 upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 13d0d6f was 13d0d6f, checked in by Fernando de Oliveira <fernando@…>, 6 years ago
  • Update to firefox-43.0.3.
  • Update to audacious-3.7.1, audacious-plugins-3.7.1.
  • Update to xapian-core-1.2.22.
  • Update to wireshark-2.0.1.
  • Update to doxygen-1.8.11.

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

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