source: xsoft/graphweb/firefox.xml@ 87068b5

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 87068b5 was 87068b5, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Move deprecated gnome packages and gnucash to the archive.

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

  • Property mode set to 100644
File size: 15.5 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-ftp
10 "ftp://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
11 <!ENTITY firefox-md5sum "4ffb6d1c1a04ca8e3dbca23df09626dd">
12 <!ENTITY firefox-size "107 MB">
13 <!ENTITY firefox-buildsize "4.4 GB (46 MB installed) (or 784 MB and 4.2 MB if using Xulrunner)">
14 <!ENTITY firefox-time "32 SBU (0.2 SBU if using Xulrunner)">
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 &lfs73_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">Additional Download (if linking against xulrunner)</bridgehead>
76 <itemizedlist spacing='compact'>
77 <listitem>
78 <para>Recommended Patch: <ulink
79 url="&patch-root;/firefox-&firefox-version;-search_box_fix-1.patch"/></para>
80 </listitem>
81 </itemizedlist>
82
83 <bridgehead renderas="sect3">Firefox Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required">
87 <xref linkend="alsa-lib"/>,
88 <xref linkend="gtk2"/>,
89 <xref linkend="zip"/>, and
90 <xref linkend="unzip"/>
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended">
95 <xref linkend="libevent"/>,
96 <xref linkend="libvpx"/>,
97 <xref linkend="nspr"/>,
98 <xref linkend="nss"/>,
99 <xref linkend="sqlite"/> and
100 <xref linkend="yasm"/>
101 </para>
102
103 <note>
104 <para>
105 If you don't install recommended dependencies,
106 then internal copies of those packages will
107 be used. They might be tested to work, but
108 they can be out of date or contain security
109 holes.
110 </para>
111 </note>
112
113 <bridgehead renderas="sect4">Optional</bridgehead>
114 <para role="optional">
115 <xref linkend="curl"/>,
116 <xref linkend="dbus-glib"/>,
117 <xref linkend="doxygen"/>,
118 <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
119 <xref linkend="libnotify"/>,
120 <xref linkend="startup-notification"/>,
121 <xref linkend="wget"/>,
122 <xref linkend="wireless_tools"/> and
123 <xref linkend="xulrunner"/>
124 </para>
125
126 <para condition="html" role="usernotes">
127 User Notes: <ulink url="&blfs-wiki;/firefox"/>
128 </para>
129 </sect2>
130
131 <sect2 role="installation">
132 <title>Installation of Firefox</title>
133
134 <para>
135 There are two major methods for building
136 <application>Firefox</application>. In the standard case, the entire suite
137 of libraries is built and installed. In the other, most of the system is
138 built using the procedures found in <xref linkend="xulrunner"/>. This is
139 advantageous if you are planning to build other related packages such as
140 <xref linkend="icedtea-web"/>. With either build method, you need to run
141 the main build procedure below with the appropriate options in the
142 <filename>mozconfig</filename> file. Then use the appropriate install
143 instructions depending on the chosen build method.
144 </para>
145
146 <para>
147 The configuration of <application>Firefox</application> is accomplished by
148 creating a <filename>mozconfig</filename> file containing the desired
149 configuration options. A default <filename>mozconfig</filename> is created
150 below. To see the entire list of available configuration options (and an
151 abbreviated description of each one), issue <command>./configure
152 --help</command>. You may also wish to review the entire file and
153 uncomment any other desired options.
154 Create the file by issuing the following command:
155 </para>
156
157<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
158# If you have a multicore machine, firefox will now use all the cores by
159# default. Exceptionally, you can reduce the number of cores, e.g. to 1,
160# by uncommenting the next line and setting a valid number of CPU cores.
161#mk_add_options MOZ_MAKE_FLAGS="-j1"
162
163# If you have installed DBus-Glib comment out this line:
164ac_add_options --disable-dbus
165
166# If you have installed wireless-tools comment out this line:
167ac_add_options --disable-necko-wifi
168
169# If you have installed libnotify comment out this line:
170ac_add_options --disable-libnotify
171
172# Uncomment these lines if you have installed optional dependencies:
173#ac_add_options --enable-system-hunspell
174#ac_add_options --enable-startup-notification
175
176# If you have not installed Yasm then uncomment this line:
177#ac_add_options --disable-webm
178
179# If you have installed xulrunner uncomment the next two ac_add_options lines
180# and check that the sdk will be set by running pkg-config in a subshell
181# and has not become hardcoded or empty when you created this file
182#ac_add_options --with-system-libxul
183#ac_add_options --with-libxul-sdk=$(pkg-config --variable=sdkdir libxul)
184
185# Comment out following options if you have not installed
186# recommended dependencies:
187ac_add_options --enable-system-sqlite
188ac_add_options --with-system-libevent
189ac_add_options --with-system-libvpx
190ac_add_options --with-system-nspr
191ac_add_options --with-system-nss
192
193# It is recommended not to touch anything below this line
194ac_add_options --prefix=/usr
195ac_add_options --enable-application=browser
196
197ac_add_options --disable-crashreporter
198ac_add_options --disable-installer
199ac_add_options --disable-updater
200ac_add_options --disable-debug
201ac_add_options --disable-tests
202
203ac_add_options --enable-optimize
204ac_add_options --enable-strip
205ac_add_options --enable-install-strip
206
207ac_add_options --enable-gio
208ac_add_options --enable-official-branding
209ac_add_options --enable-safe-browsing
210ac_add_options --enable-url-classifier
211
212ac_add_options --enable-system-ffi
213ac_add_options --enable-system-pixman
214
215ac_add_options --with-pthreads
216
217ac_add_options --with-system-bz2
218ac_add_options --with-system-jpeg
219ac_add_options --with-system-png
220ac_add_options --with-system-zlib
221
222mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir
223EOF</userinput></screen>
224
225 <para>
226 If you are building against an already installed <application>Xulrunner</application>
227 apply the patch:
228 </para>
229
230<screen><userinput>patch -Np1 -i ../firefox-&firefox-version;-search_box_fix-1.patch
231</userinput></screen>
232
233 <para>
234 Compile <application>Firefox</application> by issuing the following
235 commands:
236 </para>
237
238<screen><userinput>sed -i 's@ ""@@' browser/base/Makefile.in &amp;&amp;
239make -f client.mk</userinput></screen>
240
241 <para>
242 This package does not come with a test suite.
243 </para>
244
245 <para>
246 If you have <emphasis>not</emphasis> linked
247 <application>Firefox</application> against an installed
248 <application>Xulrunner</application>:
249 </para>
250
251<screen><userinput>make -C firefox-build-dir/browser/installer</userinput></screen>
252
253 <para>
254 Now, as the <systemitem class="username">root</systemitem> user, if you
255 have <emphasis>not</emphasis> linked <application>Firefox</application>
256 against an installed <application>Xulrunner</application>, install the
257 package:
258 </para>
259
260<screen role="root"><userinput>rm -rf /usr/lib/firefox-&firefox-version; &amp;&amp;
261mkdir /usr/lib/firefox-&firefox-version; &amp;&amp;
262
263tar -xvf firefox-build-dir/dist/firefox-&firefox-version;.en-US.linux-$(uname -m).tar.bz2 \
264 -C /usr/lib/firefox-&firefox-version; --strip-components=1 &amp;&amp;
265chown -R -v root:root /usr/lib/firefox-&firefox-version; &amp;&amp;
266
267ln -sfv ../lib/firefox-&firefox-version;/firefox /usr/bin &amp;&amp;
268
269mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
270ln -sfv ../mozilla/plugins /usr/lib/firefox-&firefox-version;</userinput></screen>
271
272 <para>
273 If you <emphasis>have</emphasis> linked against an already installed
274 <application>Xulrunner</application>, as the
275 <systemitem class="username">root</systemitem> user:
276 </para>
277
278<screen role="root"><userinput>make -C firefox-build-dir install &amp;&amp;
279ln -sfv ../lib/firefox-&firefox-version;/firefox /usr/bin &amp;&amp;
280ln -sfv ../xulrunner-&firefox-version; /usr/lib/firefox-&firefox-version;/xulrunner &amp;&amp;
281
282mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
283ln -sfv ../mozilla/plugins /usr/lib/firefox-&firefox-version;</userinput></screen>
284
285 <bridgehead renderas="sect3" id="npapi-firefox" xreflabel="Firefox">
286 NPAPI Headers
287 </bridgehead>
288
289 <para>
290 The above instructions just install the parts you need to run
291 <application>Firefox</application>. If you want to compile
292 <xref linkend="gnash"/>, the open source version of Flash, copy some
293 headers that Gnash needs into /usr/include, as the
294 <systemitem class="username">root</systemitem> user:
295 </para>
296
297<screen role="root"><userinput>rm -rf /usr/include/npapi &amp;&amp;
298mkdir -v /usr/include/npapi &amp;&amp;
299cp -v dom/plugins/base/*.h /usr/include/npapi</userinput></screen>
300
301 <note>
302 <para>
303 You don't need to install the headers if you have built
304 <application>Firefox</application> against
305 <application>Xulrunner</application>.
306 </para>
307 </note>
308
309 </sect2>
310
311 <sect2 role="commands">
312 <title>Command Explanations</title>
313
314 <para>
315 <command>sed -i 's@ ""@@' browser/base/Makefile.in</command>: This sed
316 removes an unprintable control character from the title bar.
317 </para>
318
319 <para>
320 <command>make -f client.mk ...</command>: Mozilla products are packaged to
321 allow the use of a configuration file which can be used to pass the
322 configuration settings to the <command>configure</command> command.
323 <command>make</command> uses the <filename>client.mk</filename> file to
324 get initial configuration and setup parameters.
325 </para>
326
327 <para>
328 <command>make -C firefox-build-dir/browser/installer</command>: this
329 creates a <application>Firefox</application> tarball similar to the ones
330 you can download from Mozilla.
331 </para>
332
333 <para>
334 <command>tar -xfv firefox-build-dir/dist ...</command>: This untars
335 <application>Firefox</application> in /usr/lib. The
336 <option>--strip-components=1</option> option removes the leading
337 'firefox' directory from the filenames, allowing us to untar it
338 into a versioned directory.
339 </para>
340
341 <para>
342 <command>make -C firefox-build-dir install</command>: This runs
343 <command>make install</command> in firefox-build-dir.
344 </para>
345
346 <para>
347 <command>ln -sfv ... /usr/bin/firefox</command>: This puts a symbolic link
348 to the <command>firefox</command> executable in your <envar>PATH</envar>
349 variable.
350 </para>
351
352 <para>
353 <command>mkdir -p /usr/lib/mozilla/plugins</command>: This checks
354 that <filename class="directory">/usr/lib/mozilla/plugins</filename>
355 exists.
356 </para>
357
358 <para>
359 <command>ln -sv ... /usr/lib/firefox-&firefox-version;</command>: This
360 command creates a symbolic link to
361 <filename class="directory">/usr/lib/mozilla/plugins</filename>. It's not
362 really needed, as <application>Firefox</application> checks
363 <filename class="directory">/usr/lib/mozilla/plugins</filename> by
364 default, but the symbolic link is made to keep all the plugins installed in
365 one folder.
366 </para>
367
368 </sect2>
369
370 <sect2 role="configuration">
371 <title>Configuring Firefox</title>
372
373 <para>
374 If you deleted the <option>--disable-webm</option> option from your
375 <filename>mozconfig</filename>, your <application>Firefox</application>
376 can play most YouTube videos without the need for the flash plugin. To
377 enable this, go to <ulink url="http://www.youtube.com/html5"/> and click
378 on 'Join the HTML5 Trial' (needs cookies enabled).
379 </para>
380
381 <para>
382 If you use a desktop environment like <application>Gnome</application> or
383 <application>KDE</application> you may like to create a
384 <filename>firefox.desktop</filename> file so that
385 <application>Firefox</application> appears in the panel's menus. If you
386 didn't enable startup-notification in your mozconfig change the
387 StartupNotify line to false. As the
388 <systemitem class="username">root</systemitem> user:
389 </para>
390
391<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
392mkdir -pv /usr/share/pixmaps &amp;&amp;
393
394cat &gt; /usr/share/applications/firefox.desktop &lt;&lt; "EOF" &amp;&amp;
395[Desktop Entry]
396Encoding=UTF-8
397Name=Firefox Web Browser
398Comment=Browse the World Wide Web
399GenericName=Web Browser
400Exec=firefox %u
401Terminal=false
402Type=Application
403Icon=firefox
404Categories=GNOME;GTK;Network;WebBrowser;
405MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
406StartupNotify=true
407EOF
408
409ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \
410 /usr/share/pixmaps/firefox.png</userinput></screen>
411
412 </sect2>
413
414 <sect2 role="content">
415 <title>Contents</title>
416
417 <segmentedlist>
418 <segtitle>Installed Programs</segtitle>
419 <segtitle>Installed Libraries</segtitle>
420 <segtitle>Installed Directories</segtitle>
421
422 <seglistitem>
423 <seg>
424 firefox
425 </seg>
426 <seg>
427 Numerous libraries, browser components, plugins, extensions, and
428 helper modules installed in
429 <filename class="directory">/usr/lib/firefox-&firefox-version;</filename>
430 </seg>
431 <seg>
432 /usr/include/npapi and
433 /usr/lib/firefox-&firefox-version;
434 </seg>
435 </seglistitem>
436 </segmentedlist>
437
438 <variablelist>
439 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
440 <?dbfo list-presentation="list"?>
441 <?dbhtml list-presentation="table"?>
442
443 <varlistentry id="firefox-prog">
444 <term><command>firefox</command></term>
445 <listitem>
446 <para>
447 is a <application>GTK+ 2</application> internet browser that uses the
448 Mozilla Gecko rendering engine.
449 </para>
450 <indexterm zone="firefox firefox-prog">
451 <primary sortas="b-firefox">firefox</primary>
452 </indexterm>
453 </listitem>
454 </varlistentry>
455
456 </variablelist>
457
458 </sect2>
459
460</sect1>
Note: See TracBrowser for help on using the repository browser.