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

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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 376c8c0 was 376c8c0, checked in by Krejzi <krejzi@…>, 8 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
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 "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)">
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">Firefox Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="alsa-lib"/>,
80 <xref linkend="gtk2"/>,
81 <xref linkend="zip"/>, and
82 <xref linkend="unzip"/>
83 </para>
84
85 <bridgehead renderas="sect4">Recommended</bridgehead>
86 <para role="recommended">
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"/>
93 </para>
94
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
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional">
107 <xref linkend="curl"/>,
108 <xref linkend="dbus-glib"/>,
109 <xref linkend="doxygen"/>,
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>,
113 <xref linkend="libnotify"/>,
114 <xref linkend="startup-notification"/>,
115 <xref linkend="wget"/>,
116 <xref linkend="wireless_tools"/> and
117 <xref linkend="xulrunner"/>
118 </para>
119
120 <para condition="html" role="usernotes">
121 User Notes: <ulink url="&blfs-wiki;/firefox"/>
122 </para>
123 </sect2>
124
125 <sect2 role="installation">
126 <title>Installation of Firefox</title>
127
128 <para>
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.
138 </para>
139
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
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:
152 </para>
153
154<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
155# If you have a multicore machine you can speed up the build by running
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"
159
160# If you have installed DBus-Glib comment out this line:
161ac_add_options --disable-dbus
162
163# If you have installed wireless-tools comment out this line:
164ac_add_options --disable-necko-wifi
165
166# If you have installed libnotify comment out this line:
167ac_add_options --disable-libnotify
168
169# Uncomment these lines if you have installed optional dependencies:
170#ac_add_options --enable-system-hunspell
171#ac_add_options --enable-startup-notification
172
173# If you have not installed Yasm then uncomment this line:
174#ac_add_options --disable-webm
175
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)
179
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
189ac_add_options --prefix=/usr
190ac_add_options --enable-application=browser
191
192ac_add_options --disable-crashreporter
193ac_add_options --disable-installer
194ac_add_options --disable-updater
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
207ac_add_options --enable-system-ffi
208ac_add_options --enable-system-pixman
209
210ac_add_options --with-pthreads
211
212ac_add_options --with-system-bz2
213ac_add_options --with-system-jpeg
214ac_add_options --with-system-png
215ac_add_options --with-system-zlib
216
217mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir
218EOF</userinput></screen>
219
220 <para>
221 Compile <application>Firefox</application> by issuing the following
222 commands:
223 </para>
224
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;
227make -f client.mk</userinput></screen>
228
229 <para>
230 This package does not come with a test suite.
231 </para>
232
233 <para>
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:
246 </para>
247
248<screen role="root"><userinput>rm -rf /usr/lib/firefox-&firefox-version; &amp;&amp;
249mkdir /usr/lib/firefox-&firefox-version; &amp;&amp;
250
251tar -xvf firefox-build-dir/dist/firefox-&firefox-version;.en-US.linux-$(uname -m).tar.bz2 \
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;
257
258mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
259ln -sfv ../mozilla/plugins /usr/lib/firefox-&firefox-version;</userinput></screen>
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;
268ln -sfv ../lib/firefox-&firefox-version;/firefox /usr/bin &amp;&amp;
269ln -sfv ../xulrunner-&firefox-version; /usr/lib/firefox-&firefox-version;/xulrunner &amp;&amp;
270
271mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
272ln -sfv ../mozilla/plugins /usr/lib/firefox-&firefox-version;</userinput></screen>
273
274 <bridgehead renderas="sect3" id="npapi-firefox" xreflabel="Firefox">
275 NPAPI Headers
276 </bridgehead>
277
278 <para>
279 The above instructions just install the parts you need to run
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
286<screen role="root"><userinput>rm -rf /usr/include/npapi &amp;&amp;
287mkdir -v /usr/include/npapi &amp;&amp;
288cp -v dom/plugins/base/*.h /usr/include/npapi</userinput></screen>
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
298 </sect2>
299
300 <sect2 role="commands">
301 <title>Command Explanations</title>
302
303 <para>
304 <command>sed -i 's@ ""@@' browser/base/Makefile.in</command>: This sed
305 removes an unprintable control character from the title bar.
306 </para>
307
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
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
332 into a versioned directory.
333 </para>
334
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
340 <para>
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.
344 </para>
345
346 <para>
347 <command>mkdir -p /usr/lib/mozilla/plugins</command>: This checks
348 that <filename class="directory">/usr/lib/mozilla/plugins</filename>
349 exists.
350 </para>
351
352 <para>
353 <command>ln -sv ... /usr/lib/firefox-&firefox-version;</command>: This
354 command creates a symbolic link to
355 <filename class="directory">/usr/lib/mozilla/plugins</filename>. It's not
356 really needed, as <application>Firefox</application> checks
357 <filename class="directory">/usr/lib/mozilla/plugins</filename> by
358 default, but the symbolic link is made to keep all the plugins installed in
359 one folder.
360 </para>
361
362 </sect2>
363
364 <sect2 role="configuration">
365 <title>Configuring Firefox</title>
366
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>
384
385<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
386mkdir -pv /usr/share/pixmaps &amp;&amp;
387
388cat &gt; /usr/share/applications/firefox.desktop &lt;&lt; "EOF" &amp;&amp;
389[Desktop Entry]
390Encoding=UTF-8
391Name=Firefox Web Browser
392Comment=Browse the World Wide Web
393GenericName=Web Browser
394Exec=firefox %u
395Terminal=false
396Type=Application
397Icon=firefox
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;
400StartupNotify=true
401EOF
402
403ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \
404 /usr/share/pixmaps/firefox.png</userinput></screen>
405
406 </sect2>
407
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>
417 <seg>
418 firefox
419 </seg>
420 <seg>
421 Numerous libraries, browser components, plugins, extensions, and
422 helper modules installed in
423 <filename class="directory">/usr/lib/firefox-&firefox-version;</filename>
424 </seg>
425 <seg>
426 /usr/include/npapi and
427 /usr/lib/firefox-&firefox-version;
428 </seg>
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>
440 <para>
441 is a <application>GTK+ 2</application> internet browser that uses the
442 Mozilla Gecko rendering engine.
443 </para>
444 <indexterm zone="firefox firefox-prog">
445 <primary sortas="b-firefox">firefox</primary>
446 </indexterm>
447 </listitem>
448 </varlistentry>
449
450 </variablelist>
451
452 </sect2>
453
454</sect1>
Note: See TracBrowser for help on using the repository browser.