source: xsoft/graphweb/firefox.xml@ 4c2bf3d6

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 4c2bf3d6 was 4c2bf3d6, checked in by Ken Moffat <ken@…>, 11 years ago

Firefox - patch it if using xulrunner : Thanks to Fernando.

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

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