source: xsoft/graphweb/firefox.xml@ c011125

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 c011125 was c011125, checked in by Fernando de Oliveira <fernando@…>, 10 years ago

xulrunner/firefox-30.0
thunderbird-24.6.0

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

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