source: xsoft/graphweb/firefox.xml@ c5f005b

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 c5f005b was c5f005b, checked in by Igor Živković <igor@…>, 11 years ago

fixes

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

  • Property mode set to 100644
File size: 15.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 "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 "06a4c0fe8d3a979aea2fce8d0fdbf328">
12 <!ENTITY firefox-size "115 MB">
13 <!ENTITY firefox-buildsize "4.9 GB (48 MB installed) (or 814 MB and 4.6 MB if using Xulrunner)">
14 <!ENTITY firefox-time "58 SBU (0.47 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 &lfs74_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 Downloads</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="gst-plugins-good"/> and
119 <xref linkend="gst-ffmpeg"/>,
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# 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 installed GStreamer comment out this line:
177ac_add_options --disable-gstreamer
178
179# Uncomment these lines if you have installed optional dependencies:
180#ac_add_options --enable-system-hunspell
181#ac_add_options --enable-startup-notification
182
183# Uncomment this line if you compiled Cairo with --enable-tee switch and want
184# to use it instead of the bundled one:
185#ac_add_options --enable-system-cairo
186
187# If you have not installed Yasm then uncomment this line:
188#ac_add_options --disable-webm
189
190# If you have installed xulrunner uncomment the next two ac_add_options lines
191# and check that the sdk will be set by running pkg-config in a subshell
192# and has not become hardcoded or empty when you created this file
193#ac_add_options --with-system-libxul
194#ac_add_options --with-libxul-sdk=$(pkg-config --variable=sdkdir libxul)
195
196# Comment out following options if you have not installed
197# recommended dependencies:
198ac_add_options --enable-system-sqlite
199ac_add_options --with-system-libevent
200ac_add_options --with-system-libvpx
201ac_add_options --with-system-nspr
202ac_add_options --with-system-nss
203
204# It is recommended not to touch 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-installer
210ac_add_options --disable-updater
211ac_add_options --disable-debug
212ac_add_options --disable-tests
213
214ac_add_options --enable-optimize
215ac_add_options --enable-strip
216ac_add_options --enable-install-strip
217
218ac_add_options --enable-gio
219ac_add_options --enable-official-branding
220ac_add_options --enable-safe-browsing
221ac_add_options --enable-url-classifier
222
223ac_add_options --enable-system-ffi
224ac_add_options --enable-system-pixman
225
226ac_add_options --with-pthreads
227
228ac_add_options --with-system-bz2
229ac_add_options --with-system-jpeg
230ac_add_options --with-system-png
231ac_add_options --with-system-zlib
232
233mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir
234EOF</userinput></screen>
235
236 <para>
237 If you are building against an already installed <application>Xulrunner</application>
238 apply the patch:
239 </para>
240
241<screen><userinput>patch -Np1 -i ../firefox-&firefox-version;-search_box_fix-1.patch</userinput></screen>
242
243 <para>
244 Compile <application>Firefox</application> by issuing the following
245 commands:
246 </para>
247
248<screen><userinput>sed -i 's@ ""@@' browser/base/Makefile.in &amp;&amp;
249make -f client.mk</userinput></screen>
250
251 <para>
252 This package does not come with a test suite.
253 </para>
254
255 <para>
256 If you have <emphasis>not</emphasis> linked
257 <application>Firefox</application> against an installed
258 <application>Xulrunner</application>:
259 </para>
260
261<screen><userinput>make -C firefox-build-dir/browser/installer</userinput></screen>
262
263 <para>
264 Now, as the <systemitem class="username">root</systemitem> user, if you
265 have <emphasis>not</emphasis> linked <application>Firefox</application>
266 against an installed <application>Xulrunner</application>, install the
267 package:
268 </para>
269
270<screen role="root"><userinput>rm -rf /usr/lib/firefox-&firefox-version; &amp;&amp;
271mkdir /usr/lib/firefox-&firefox-version; &amp;&amp;
272
273tar -xvf firefox-build-dir/dist/firefox-&firefox-version;.en-US.linux-$(uname -m).tar.bz2 \
274 -C /usr/lib/firefox-&firefox-version; --strip-components=1 &amp;&amp;
275chown -R -v root:root /usr/lib/firefox-&firefox-version; &amp;&amp;
276
277ln -sfv ../lib/firefox-&firefox-version;/firefox /usr/bin &amp;&amp;
278
279mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
280ln -sfv ../mozilla/plugins /usr/lib/firefox-&firefox-version;</userinput></screen>
281
282 <para>
283 If you <emphasis>have</emphasis> linked against an already installed
284 <application>Xulrunner</application>, as the
285 <systemitem class="username">root</systemitem> user:
286 </para>
287
288<screen role="root"><userinput>make -C firefox-build-dir install &amp;&amp;
289ln -sfv ../lib/firefox-&firefox-version;/firefox /usr/bin &amp;&amp;
290ln -sfv ../xulrunner-&firefox-version; /usr/lib/firefox-&firefox-version;/xulrunner &amp;&amp;
291
292mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
293ln -sfv ../mozilla/plugins /usr/lib/firefox-&firefox-version;</userinput></screen>
294
295 </sect2>
296
297 <sect2 role="commands">
298 <title>Command Explanations</title>
299
300 <para>
301 <command>sed -i 's@ ""@@' browser/base/Makefile.in</command>: This sed
302 removes an unprintable control character from the title bar.
303 </para>
304
305 <para>
306 <command>make -f client.mk ...</command>: Mozilla products are packaged to
307 allow the use of a configuration file which can be used to pass the
308 configuration settings to the <command>configure</command> command.
309 <command>make</command> uses the <filename>client.mk</filename> file to
310 get initial configuration and setup parameters.
311 </para>
312
313 <para>
314 <command>make -C firefox-build-dir/browser/installer</command>: this
315 creates a <application>Firefox</application> tarball similar to the ones
316 you can download from Mozilla.
317 </para>
318
319 <para>
320 <command>tar -xfv firefox-build-dir/dist ...</command>: This untars
321 <application>Firefox</application> in /usr/lib. The
322 <option>--strip-components=1</option> option removes the leading
323 'firefox' directory from the filenames, allowing us to untar it
324 into a versioned directory.
325 </para>
326
327 <para>
328 <command>make -C firefox-build-dir install</command>: This runs
329 <command>make install</command> in firefox-build-dir.
330 </para>
331
332 <para>
333 <command>ln -sfv ... /usr/bin/firefox</command>: This puts a symbolic link
334 to the <command>firefox</command> executable in your <envar>PATH</envar>
335 variable.
336 </para>
337
338 <para>
339 <command>mkdir -p /usr/lib/mozilla/plugins</command>: This checks
340 that <filename class="directory">/usr/lib/mozilla/plugins</filename>
341 exists.
342 </para>
343
344 <para>
345 <command>ln -sv ... /usr/lib/firefox-&firefox-version;</command>: This
346 command creates a symbolic link to
347 <filename class="directory">/usr/lib/mozilla/plugins</filename>. It's not
348 really needed, as <application>Firefox</application> checks
349 <filename class="directory">/usr/lib/mozilla/plugins</filename> by
350 default, but the symbolic link is made to keep all the plugins installed in
351 one folder.
352 </para>
353
354 </sect2>
355
356 <sect2 role="configuration">
357 <title>Configuring Firefox</title>
358
359 <para>
360 If you deleted the <option>--disable-webm</option> option from your
361 <filename>mozconfig</filename>, your <application>Firefox</application>
362 can play most YouTube videos without the need for the flash plugin. To
363 enable this, go to <ulink url="http://www.youtube.com/html5"/> and click
364 on 'Join the HTML5 Trial' (needs cookies enabled).
365 </para>
366
367 <para>
368 If you use a desktop environment like <application>Gnome</application> or
369 <application>KDE</application> you may like to create a
370 <filename>firefox.desktop</filename> file so that
371 <application>Firefox</application> appears in the panel's menus. If you
372 didn't enable startup-notification in your mozconfig change the
373 StartupNotify line to false. As the
374 <systemitem class="username">root</systemitem> user:
375 </para>
376
377<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
378mkdir -pv /usr/share/pixmaps &amp;&amp;
379
380cat &gt; /usr/share/applications/firefox.desktop &lt;&lt; "EOF" &amp;&amp;
381<literal>[Desktop Entry]
382Encoding=UTF-8
383Name=Firefox Web Browser
384Comment=Browse the World Wide Web
385GenericName=Web Browser
386Exec=firefox %u
387Terminal=false
388Type=Application
389Icon=firefox
390Categories=GNOME;GTK;Network;WebBrowser;
391MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
392StartupNotify=true</literal>
393EOF
394
395ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \
396 /usr/share/pixmaps/firefox.png</userinput></screen>
397
398 </sect2>
399
400 <sect2 role="content">
401 <title>Contents</title>
402
403 <segmentedlist>
404 <segtitle>Installed Programs</segtitle>
405 <segtitle>Installed Libraries</segtitle>
406 <segtitle>Installed Directory</segtitle>
407
408 <seglistitem>
409 <seg>
410 firefox
411 </seg>
412 <seg>
413 Numerous libraries, browser components, plugins, extensions, and
414 helper modules installed in
415 <filename class="directory">/usr/lib/firefox-&firefox-version;</filename>
416 </seg>
417 <seg>
418 /usr/lib/firefox-&firefox-version;
419 </seg>
420 </seglistitem>
421 </segmentedlist>
422
423 <variablelist>
424 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
425 <?dbfo list-presentation="list"?>
426 <?dbhtml list-presentation="table"?>
427
428 <varlistentry id="firefox-prog">
429 <term><command>firefox</command></term>
430 <listitem>
431 <para>
432 is a <application>GTK+ 2</application> internet browser that uses the
433 Mozilla Gecko rendering engine.
434 </para>
435 <indexterm zone="firefox firefox-prog">
436 <primary sortas="b-firefox">firefox</primary>
437 </indexterm>
438 </listitem>
439 </varlistentry>
440
441 </variablelist>
442
443 </sect2>
444
445</sect1>
Note: See TracBrowser for help on using the repository browser.