source: xsoft/graphweb/firefox.xml@ 376c8c0

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 376c8c0 was 376c8c0, checked in by Krejzi <krejzi@…>, 11 years ago

Fix Firefox instructions.

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

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