source: xsoft/graphweb/firefox.xml@ f9a2b451

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

Send xulrunner to retirement.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@14058 af4574ff-66df-0310-9fd7-8a98e5e911e0

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