source: xsoft/graphweb/firefox.xml@ c85febe

systemd-11177
Last change on this file since c85febe was eedffa0, checked in by Krejzi <krejzi@…>, 10 years ago

Fix a typo and few minor fixes.

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