source: xsoft/graphweb/firefox.xml@ a30a874

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 nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a30a874 was a30a874, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Tags to finish xorg drivers.
Archive cirrus and vesa xorg drivers
Archive gnash.
Finish tagging X appplication packages

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