source: xsoft/graphweb/firefox.xml@ a7b45fd

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 upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a7b45fd was a7b45fd, checked in by Andrew Benton <andy@…>, 10 years ago

libunique-1.1.6

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

  • Property mode set to 100644
File size: 12.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 "http://releases.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
8 <!ENTITY firefox-download-ftp "ftp://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
9 <!ENTITY firefox-md5sum "7cf2bd379792a9b232267c6a79680566">
10 <!ENTITY firefox-size "70.8 MB">
11 <!ENTITY firefox-buildsize "3 GB (33 MB installed)">
12 <!ENTITY firefox-time "24 SBU (or 0.3 SBU if you&apos;re building against
13 an installed Xulrunner)">
14]>
15
16<sect1 id="firefox" xreflabel="Firefox-&firefox-version;">
17 <?dbhtml filename="firefox.html" ?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Firefox-&firefox-version;</title>
25
26 <indexterm zone="firefox">
27 <primary sortas="a-Firefox">Firefox</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Firefox</title>
32
33 <para><application>Firefox</application> is a stand-alone browser
34 based on the <application>Mozilla</application> codebase.</para>
35
36 &lfs70_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&firefox-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&firefox-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &firefox-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &firefox-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &firefox-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &firefox-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
61 <itemizedlist spacing="compact">
62 <listitem>
63 <para>Required patch:
64 <ulink
65 url="&patch-root;/firefox-&firefox-version;-libpng-1.5-1.patch"/></para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">Firefox Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required"><xref linkend="alsa-lib"/>, <xref linkend="gtk2"/>,
73 <xref linkend="zip"/> and <xref linkend="unzip"/>.</para>
74
75 <para>Note: <application>libjpeg</application> and
76 <application>libpng</application> (patched for apng support) should have
77 been installed before <application>gdk-pixbuf</application> and should
78 exist on your system. If for some strange reason you haven&apos;t installed
79 them, you should remove the <option>--with-system-jpeg</option> and
80 <option>--with-system-png</option> options from the
81 <filename>mozconfig</filename> file created below.</para>
82
83 <bridgehead renderas="sect4">Recommended</bridgehead>
84 <para role="recommended"><xref linkend="yasm"/> or
85 <xref linkend="libvpx"/> (to allow <application>Firefox</application> to
86 play webm videos).</para>
87
88 <bridgehead renderas="sect4">Optional</bridgehead>
89 <para role="optional"><xref linkend="dbus-glib"/>,
90 <xref linkend="startup-notification"/>, <xref linkend="sqlite"/>,
91 <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
92 <xref linkend="doxygen"/>, <xref linkend="gnome-vfs"/> and
93 <xref linkend="libgnomeui"/> (for gnome integration),
94 <xref linkend="libnotify"/>, <xref linkend="nspr"/>, <xref linkend="nss"/>,
95 <xref linkend="xulrunner"/> (linking against an installed xulrunner makes
96 Firefox about 32 MB smaller, which is trivial compared to the size of
97 xulrunner), <xref linkend="wireless_tools"/>,
98 <ulink url="http://www.valgrind.org/">Valgrind</ulink> (only for testing
99 the jemalloc code) and <xref linkend="wget"/></para>
100
101 <para condition="html" role="usernotes">User Notes:
102 <ulink url="&blfs-wiki;/firefox"/></para>
103
104 </sect2>
105
106 <sect2 role="installation">
107 <title>Installation of Firefox</title>
108
109 <para>The configuration of <application>Firefox</application> is
110 accomplished by creating a <filename>mozconfig</filename> file containing
111 the desired configuration options. A default <filename>mozconfig</filename>
112 is created below. To see the entire list of available configuration options
113 (and an abbreviated description of each one), issue
114 <command>./configure --help</command>. You may also wish to review the
115 entire file and uncomment any other desired options. Create the file by
116 issuing the following command:</para>
117
118<screen><?dbfo keep-together="auto"?><userinput>patch -p1 &lt; ../firefox-&firefox-version;-libpng-1.5-1.patch &amp;&amp;
119cat &gt; mozconfig &lt;&lt; "EOF"
120# If you have a multicore machine you can speed up the build by running
121# several jobs at once, but if you have a single core, delete this line:
122mk_add_options MOZ_MAKE_FLAGS="-j4"
123
124# If you have installed Yasm delete this option:
125ac_add_options --disable-webm
126
127# If you have installed DBus-Glib delete this option:
128ac_add_options --disable-dbus
129
130# If you have installed wireless-tools delete this option:
131ac_add_options --disable-necko-wifi
132
133# If you have installed libnotify delete this option:
134ac_add_options --disable-libnotify
135
136# If you have installed xulrunner uncomment these two lines:
137# ac_add_options --with-system-libxul
138# ac_add_options --with-libxul-sdk=/usr/lib/xulrunner-devel-&xulrunner-version;
139
140# Uncomment these if you have installed them:
141# ac_add_options --with-system-nspr
142# ac_add_options --with-system-nss
143# ac_add_options --enable-system-sqlite
144# ac_add_options --with-system-libvpx
145# ac_add_options --enable-startup-notification
146# ac_add_options --enable-system-hunspell
147
148mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir
149ac_add_options --enable-official-branding
150ac_add_options --prefix=/usr
151
152# The rest of these options have no effect if you&apos;re
153# building against an already installed xulrunner:
154ac_add_options --with-pthreads
155ac_add_options --enable-system-ffi
156ac_add_options --with-system-jpeg
157ac_add_options --with-system-png
158ac_add_options --enable-system-cairo
159ac_add_options --with-system-zlib
160ac_add_options --enable-shared
161ac_add_options --disable-static
162ac_add_options --disable-debug
163ac_add_options --disable-crashreporter
164ac_add_options --disable-installer
165ac_add_options --disable-updater
166ac_add_options --disable-tests
167EOF</userinput></screen>
168
169 <para>Compile <application>Firefox</application> by issuing the
170 following commands:</para>
171
172<screen><userinput>sed -i 's# ""##' browser/base/Makefile.in &amp;&amp;
173make -f client.mk</userinput></screen>
174
175 <para>If you have <emphasis>not</emphasis> linked
176 <application>Firefox</application> against an installed
177 <application>Xulrunner</application>:</para>
178
179<screen><userinput>make -C firefox-build-dir/browser/installer</userinput></screen>
180
181 <para>This package does not come with a test suite.</para>
182
183 <para>Now, if you have <emphasis>not</emphasis> linked
184 <application>Firefox</application> against an installed
185 <application>Xulrunner</application>, as the
186 <systemitem class="username">root</systemitem> user, install the
187 package:</para>
188
189<screen role="root"><userinput>mkdir /usr/lib/firefox-&firefox-version; &amp;&amp;
190tar -xvf firefox-build-dir/dist/firefox-*.tar.bz2 -C /usr/lib/firefox-&firefox-version; --strip-components=1 &amp;&amp;
191ln -sfv ../lib/firefox-&firefox-version;/firefox /usr/bin/firefox &amp;&amp;
192mkdir -p /usr/lib/mozilla/plugins &amp;&amp;
193ln -sv ../mozilla/plugins /usr/lib/firefox-&firefox-version; &amp;&amp;
194chown -R -v root:root /usr/lib/firefox-&firefox-version;</userinput></screen>
195
196 <para>If you <emphasis>have</emphasis> linked against an already installed
197 <application>Xulrunner</application>, as the
198 <systemitem class="username">root</systemitem> user:</para>
199
200<screen role="root"><userinput>make -C firefox-build-dir install &amp;&amp;
201rm /usr/bin/firefox &amp;&amp;
202cat &gt; /usr/bin/firefox &lt;&lt; "EOF" &amp;&amp;
203#!/bin/bash
204/usr/lib/xulrunner-&xulrunner-version;/xulrunner /usr/lib/firefox-&firefox-version;/application.ini "${@}"
205EOF
206chmod 755 /usr/bin/firefox &amp;&amp;
207mkdir -p /usr/lib/mozilla/plugins &amp;&amp;
208ln -sv ../mozilla/plugins /usr/lib/firefox-&firefox-version; &amp;&amp;
209chown -R -v root:root /usr/lib/firefox-&firefox-version;</userinput></screen>
210
211 </sect2>
212
213 <sect2 role="commands">
214 <title>Command Explanations</title>
215
216 <para><command>sed -i 's# ""##' browser/base/Makefile.in</command>: This
217 removes an unprintable control character from the title bar.</para>
218
219 <para><command>make -f client.mk ...</command>: Mozilla products are
220 packaged to allow the use of a configuration file which can be used to
221 pass the configuration settings to the <command>configure</command>
222 command. <command>make</command> uses the <filename>client.mk</filename>
223 file to get initial configuration and setup parameters.</para>
224
225 <para><command>make -C firefox-build-dir/browser/installer</command>:
226 this creates a <application>Firefox</application> tarball.</para>
227
228 <para><command>tar -xfv firefox-build-dir/dist ...</command>: This untars
229 <application>Firefox</application> in /usr/lib. The
230 <option>--strip-components=1</option> option removes the leading
231 &apos;firefox&apos; directory from the filenames, allowing us to untar it
232 into a versioned directory. Untaring it (instead of running make install)
233 prevents it installing /usr/lib/firefox-devel-&firefox-version; which
234 contains about 430 MB of files. If you need any of those files,
235 they&apos;re in <xref linkend="xulrunner"/></para>
236
237 <para><command>make -C firefox-build-dir install</command>: This runs
238 <command>make install</command> in firefox-build-dir.</para>
239
240 <para><command>ln -sfv ... /usr/bin/firefox</command>: this puts a symbolic
241 link to the <command>firefox</command> executable in your ${PATH}.</para>
242
243 <para><command>mkdir -p /usr/lib/mozilla/plugins</command>: this checks
244 that /usr/lib/mozilla/plugins exists (if you installed
245 <xref linkend="librsvg"/>, it was probably already there).</para>
246
247 <para><command>ln -sv ... /usr/lib/firefox-&firefox-version;</command>:
248 this makes a symbolic link to /usr/lib/mozilla/plugins.</para>
249
250 </sect2>
251
252 <sect2 role="configuration">
253 <title>Configuring Firefox</title>
254
255 <para>If you deleted the <option>--disable-webm</option> option from your
256 <filename>mozconfig</filename>, your <application>Firefox</application>
257 can play most YouTube videos without the need for the flash plugin. To
258 enable this, go to <ulink
259 url="http://www.youtube.com/html5">http://www.youtube.com/html5</ulink>
260 and click on &apos;Join the HTML5 Trial&apos; (needs cookies
261 enabled).</para>
262
263 </sect2>
264
265 <sect2 role="content">
266 <title>Contents</title>
267
268 <segmentedlist>
269 <segtitle>Installed Programs</segtitle>
270 <segtitle>Installed Libraries</segtitle>
271 <segtitle>Installed Directories</segtitle>
272
273 <seglistitem>
274 <seg>firefox</seg>
275 <seg>Numerous libraries, browser components, plugins, extensions, and
276 helper modules installed in <filename
277 class="directory">/usr/lib/firefox-&firefox-version;</filename>.</seg>
278 <seg>/usr/lib/firefox-&firefox-version;</seg>
279 </seglistitem>
280 </segmentedlist>
281
282 <variablelist>
283 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
284 <?dbfo list-presentation="list"?>
285 <?dbhtml list-presentation="table"?>
286
287 <varlistentry id="firefox-prog">
288 <term><command>firefox</command></term>
289 <listitem>
290 <para>is a gtk2 internet browser that uses the gecko rendering
291 engine.</para>
292 <indexterm zone="firefox firefox-prog">
293 <primary sortas="b-firefox">firefox</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 </variablelist>
299
300 </sect2>
301
302</sect1>
Note: See TracBrowser for help on using the repository browser.