source: xsoft/graphweb/firefox.xml@ 6c6990c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 6c6990c was 6c6990c, checked in by Fernando de Oliveira <fernando@…>, 9 years ago
  • Update to firefox-40.0.
  • Update to gnutls-3.4.4.1.
  • Update to openssh-7.0p1 and ssh-askpass-7.0p1.
  • SoundTouch-1.9.0: typo and add short description.
  • GTK+-2.24.28: reformat commands to decrease width. Im

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

  • Property mode set to 100644
File size: 13.1 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 "&mozilla-http;/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
8<!-- 550 Permission denied.
9 <!ENTITY firefox-download-ftp "&mozilla-ftp;/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2"> -->
10 <!ENTITY firefox-download-ftp " ">
11 <!ENTITY firefox-md5sum "62b9e6a4a46874a0be523fe41d3176e2">
12 <!ENTITY firefox-size "171 MB">
13 <!ENTITY firefox-buildsize "3.8 GB (75 MB installed)">
14 <!ENTITY firefox-time "8.7 SBU (using parallelism=4)">
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 &lfs77_checked; &gcc5_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="nss"/>,
82 <xref linkend="unzip"/>,
83 <xref linkend="yasm"/>, and
84 <xref linkend="zip"/>
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"/>, and
92 <xref linkend="sqlite"/>
93 </para>
94
95 <note>
96 <para>
97 If you don't install recommended dependencies, then internal copies of
98 those packages will be used. They might be tested to work, but they can
99 be out of date or contain security holes.
100 </para>
101 </note>
102
103 <note>
104 <para>
105 With <application>Firefox-31.0</application> and later versions, you
106 must have installed <application>Openssl</application> before
107 <application>Python 2</application> or the build system will quickly
108 fail with output including "ImportError: cannot import name
109 HTTPSHandler". If you are in any doubt about this (e.g. upgrading from
110 an older version of Firefox), check if
111 <filename>/usr/lib/python&python2-majorver;/lib-dynload/_ssl.so</filename>
112 exists. If it does not, reinstall <xref linkend="python2"/> (after
113 installing <xref linkend="openssl"/>. The latest version of any
114 <emphasis>currently maintained</emphasis> version of Openssl should be
115 satisfactory if already installed.
116 </para>
117 </note>
118
119 <bridgehead renderas="sect4">Optional</bridgehead>
120 <para role="optional">
121 <xref linkend="curl"/>,
122 <xref linkend="dbus-glib"/>,
123 <xref linkend="doxygen"/>,
124 <xref linkend="gst10-plugins-base"/> (with
125 <xref linkend="gst10-plugins-good"/> and
126 <xref linkend="gst10-libav"/> at runtime),
127 <xref linkend="libnotify"/>,
128 <xref linkend="openjdk"/>,
129 <xref linkend="pulseaudio"/>,
130 <xref linkend="startup-notification"/>,
131 <xref linkend="valgrind"/>,
132 <xref linkend="wget"/>,
133 <xref linkend="wireless_tools"/>,
134 <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
135 <ulink url="http://sourceforge.net/projects/liboauth/files/">liboauth</ulink>, and
136 <ulink url="https://code.google.com/p/libproxy/">libproxy</ulink>, and
137 <ulink url="https://www.rust-lang.org/">Rust</ulink>
138 </para>
139
140 <para condition="html" role="usernotes">
141 User Notes: <ulink url="&blfs-wiki;/firefox"/>
142 </para>
143 </sect2>
144
145 <sect2 role="installation">
146 <title>Installation of Firefox</title>
147
148 <para>
149 The configuration of <application>Firefox</application> is accomplished
150 by creating a <filename>mozconfig</filename> file containing the desired
151 configuration options. A default <filename>mozconfig</filename> is
152 created below. To see the entire list of available configuration options
153 (and an 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. Create the file by issuing the
156 following command:
157 </para>
158
159<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
160<literal># If you have a multicore machine, all cores will be used by default.
161# If desired, you can reduce the number of cores used, e.g. to 1, by
162# 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 dbus-glib, and you have installed (or will install)
169# wireless-tools, and you wish to use geolocation web services, comment out
170# this line
171ac_add_options --disable-necko-wifi
172
173# If you have installed libnotify comment out this line:
174ac_add_options --disable-libnotify
175
176# GStreamer is necessary for H.264 video playback in HTML5 Video Player;
177# to be enabled, also remember to set "media.gstreamer.enabled" to "true"
178# in about:config. If you have GStreamer 1.x.y, comment out this line and
179# uncomment the following one:
180ac_add_options --disable-gstreamer
181#ac_add_options --enable-gstreamer=1.0
182
183# Uncomment these lines if you have installed optional dependencies:
184#ac_add_options --enable-system-hunspell
185#ac_add_options --enable-startup-notification
186
187# Comment out following option if you have PulseAudio installed
188ac_add_options --disable-pulseaudio
189<!-- Does not work uncommented
190# If you have not installed Yasm then uncomment this line:
191#ac_add_options - -disable-webm
192-->
193# Comment out following options if you have not installed
194# recommended dependencies:
195ac_add_options --enable-system-sqlite
196ac_add_options --with-system-libevent
197ac_add_options --with-system-libvpx
198ac_add_options --with-system-nspr
199ac_add_options --with-system-nss
200ac_add_options --with-system-icu
201
202# The BLFS editors recommend not changing anything below this line:
203ac_add_options --prefix=/usr
204ac_add_options --enable-application=browser
205
206ac_add_options --disable-crashreporter
207ac_add_options --disable-updater
208ac_add_options --disable-tests
209
210ac_add_options --enable-optimize
211ac_add_options --enable-strip
212ac_add_options --enable-install-strip
213
214ac_add_options --enable-gio
215ac_add_options --enable-official-branding
216ac_add_options --enable-safe-browsing
217ac_add_options --enable-url-classifier
218
219ac_add_options --enable-system-cairo
220ac_add_options --enable-system-ffi
221ac_add_options --enable-system-pixman
222
223ac_add_options --with-pthreads
224
225ac_add_options --with-system-bz2
226ac_add_options --with-system-jpeg
227ac_add_options --with-system-png
228ac_add_options --with-system-zlib
229
230mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir</literal>
231EOF</userinput></screen>
232
233 <para>
234 Compile <application>Firefox</application> by issuing the following
235 commands:
236 </para>
237
238 <note><para>
239 If you are compiling <application>Firefox</application> in chroot, make
240 sure you have <envar>$SHELL</envar> environment variable set or prepend
241 <envar>SHELL=/bin/sh</envar>.
242 </para></note>
243
244<screen><userinput>make -f client.mk</userinput></screen>
245
246 <para>
247 This package does not come with a test suite.
248 </para>
249
250 <para>
251 Now, as the <systemitem class="username">root</systemitem> user:
252 </para>
253
254<screen role="root"><userinput>make -f client.mk install INSTALL_SDK= &amp;&amp;
255
256chown -R 0:0 /usr/lib/firefox-&firefox-version; &amp;&amp;
257mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
258ln -sfv ../../mozilla/plugins /usr/lib/firefox-&firefox-version;/browser</userinput></screen>
259
260 </sect2>
261
262 <sect2 role="commands">
263 <title>Command Explanations</title>
264
265 <para>
266 <command>make -f client.mk ...</command>: Mozilla products are packaged to
267 allow the use of a configuration file which can be used to pass the
268 configuration settings to the <command>configure</command> command.
269 <command>make</command> uses the <filename>client.mk</filename> file to
270 get initial configuration and setup parameters.
271 </para>
272
273 <para>
274 <command>make -C firefox-build-dir install</command>: This runs
275 <command>make install</command> in firefox-build-dir.
276 </para>
277
278 <para>
279 <command>ln -sfv ... /usr/bin/firefox</command>: This puts a symbolic link
280 to the <command>firefox</command> executable in your <envar>PATH</envar>
281 variable.
282 </para>
283
284 <para>
285 <command>mkdir -p /usr/lib/mozilla/plugins</command>: This checks
286 that <filename class="directory">/usr/lib/mozilla/plugins</filename>
287 exists.
288 </para>
289
290 <para>
291 <command>ln -sv ... /usr/lib/firefox-&firefox-version;/browser</command>:
292 This command creates a symbolic link to <filename
293 class="directory">/usr/lib/mozilla/plugins</filename>. It's not really
294 needed, as <application>Firefox</application> checks <filename
295 class="directory">/usr/lib/mozilla/plugins</filename> by default, but the
296 symbolic link is made to keep all the plugins installed in one folder.
297 </para>
298
299 </sect2>
300
301 <sect2 role="configuration">
302 <title>Configuring Firefox</title>
303
304 <para>
305 If you did not add the <option>--disable-webm</option> option to your
306 <filename>mozconfig</filename>, your <application>Firefox</application>
307 can play most YouTube videos without the need for the flash plugin. To
308 enable this, go to <ulink url="http://www.youtube.com/html5"/> and click
309 on 'Join the HTML5 Trial' (needs cookies enabled).
310 </para>
311
312 <para>
313 If you use a desktop environment like <application>Gnome</application> or
314 <application>KDE</application> you may like to create a
315 <filename>firefox.desktop</filename> file so that
316 <application>Firefox</application> appears in the panel's menus. If you
317 didn't enable startup-notification in your mozconfig change the
318 StartupNotify line to false. As the
319 <systemitem class="username">root</systemitem> user:
320 </para>
321
322<screen role="root"><userinput>mkdir -pv /usr/share/applications &amp;&amp;
323mkdir -pv /usr/share/pixmaps &amp;&amp;
324
325cat &gt; /usr/share/applications/firefox.desktop &lt;&lt; "EOF" &amp;&amp;
326<literal>[Desktop Entry]
327Encoding=UTF-8
328Name=Firefox Web Browser
329Comment=Browse the World Wide Web
330GenericName=Web Browser
331Exec=firefox %u
332Terminal=false
333Type=Application
334Icon=firefox
335Categories=GNOME;GTK;Network;WebBrowser;
336MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https;
337StartupNotify=true</literal>
338EOF
339
340ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \
341 /usr/share/pixmaps/firefox.png</userinput></screen>
342
343 </sect2>
344
345 <sect2 role="content">
346 <title>Contents</title>
347
348 <segmentedlist>
349 <segtitle>Installed Programs</segtitle>
350 <segtitle>Installed Libraries</segtitle>
351 <segtitle>Installed Directory</segtitle>
352
353 <seglistitem>
354 <seg>
355 firefox
356 </seg>
357 <seg>
358 Numerous libraries, browser components, plugins, extensions, and
359 helper modules installed in
360 <filename class="directory">/usr/lib/firefox-&firefox-version;</filename>
361 </seg>
362 <seg>
363 /usr/lib/firefox-&firefox-version;
364 </seg>
365 </seglistitem>
366 </segmentedlist>
367
368 <variablelist>
369 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
370 <?dbfo list-presentation="list"?>
371 <?dbhtml list-presentation="table"?>
372
373 <varlistentry id="firefox-prog">
374 <term><command>firefox</command></term>
375 <listitem>
376 <para>
377 is a <application>GTK+ 2</application> internet browser that uses the
378 Mozilla Gecko rendering engine.
379 </para>
380 <indexterm zone="firefox firefox-prog">
381 <primary sortas="b-firefox">firefox</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 </variablelist>
387
388 </sect2>
389
390</sect1>
Note: See TracBrowser for help on using the repository browser.