source: xsoft/graphweb/firefox.xml@ 622f1c7

10.0 10.1 11.0 11.1 6.3 6.3-rc1 6.3-rc2 6.3-rc3 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 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 622f1c7 was 622f1c7, checked in by Dan Nichilson <dnicholson@…>, 15 years ago

Fixed Firefox and Thunderbird to ensure libXrender and libX11 are found

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

  • Property mode set to 100644
File size: 19.3 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 "24398e3d98673a2a92a01a8f771ca12a">
10 <!ENTITY firefox-size "35.4 MB">
11 <!ENTITY firefox-buildsize "455 MB">
12 <!ENTITY firefox-time "9.9 SBU">
13]>
14
15<sect1 id="firefox" xreflabel="Firefox-&firefox-version;">
16 <?dbhtml filename="firefox.html" ?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Firefox-&firefox-version;</title>
24
25 <indexterm zone="firefox">
26 <primary sortas="a-Firefox">Firefox</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Firefox</title>
31
32 <para><application>Firefox</application> is a stand-alone browser
33 based on the <application>Mozilla</application> codebase.</para>
34
35 <bridgehead renderas="sect3">Package Information</bridgehead>
36 <itemizedlist spacing="compact">
37 <listitem>
38 <para>Download (HTTP): <ulink url="&firefox-download-http;"/></para>
39 </listitem>
40 <listitem>
41 <para>Download (FTP): <ulink url="&firefox-download-ftp;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download MD5 sum: &firefox-md5sum;</para>
45 </listitem>
46 <listitem>
47 <para>Download size: &firefox-size;</para>
48 </listitem>
49 <listitem>
50 <para>Estimated disk space required: &firefox-buildsize;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated build time: &firefox-time;</para>
54 </listitem>
55 </itemizedlist>
56
57 <bridgehead renderas="sect3">Firefox Dependencies</bridgehead>
58
59 <bridgehead renderas="sect4">Required</bridgehead>
60 <para role="required"><xref linkend="gtk2"/>,
61 <xref linkend="libidl"/>, and
62 <xref linkend="zip"/></para>
63
64 <para>Note: <application>libjpeg</application> should have been installed
65 before <application>GTK+</application> and should exist on your system. If
66 for some reason you haven't installed <application>libjpeg</application>,
67 you should remove the <option>--with-system-jpeg</option> option from the
68 <filename>.mozconfig</filename> file created below.</para>
69
70 <bridgehead renderas="sect4">Recommended (if you will be installing any
71 other package that utilizes NSS/NSPR, such as
72 <application>Thunderbird</application>,
73 <application>Mozilla</application>,
74 <application>Evolution</application>, or
75 <application>OpenOffice</application>)</bridgehead>
76 <para role="recommended"><xref linkend="nss"/></para>
77
78 <bridgehead renderas="sect4">Optional</bridgehead>
79 <para role="optional"><xref linkend="unzip"/> and
80 <xref linkend="libgnomeui"/> (to build the gnomevfs extension)</para>
81
82 <para condition="html" role="usernotes">User Notes:
83 <ulink url="&blfs-wiki;/firefox"/></para>
84
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of Firefox</title>
89
90 <para>The configuration of <application>Firefox</application> is
91 accomplished by creating a <filename>.mozconfig</filename> file containing
92 the desired configuration options. A default <filename>.mozconfig</filename>
93 is created below. To see the entire list of available configuration options
94 (and an abbreviated description of each one), issue
95 <command>./configure --help</command>. If you are going to use
96 system-installed versions of the <application>NSS</application> and
97 <application>NSPR</application> libraries, ensure you uncomment the two
98 lines near the bottom of the file. If you are going to build the
99 <application>OpenOffice</application> package and you want to use this
100 <application>Firefox</application> installation as the default
101 <application>Mozilla</application> source, ensure you uncomment the
102 <option>--enable-ldap</option> option in the file created below.
103 You may also wish to review the entire file and uncomment any other desired
104 options. If you would prefer to download the file instead of creating it by
105 typing or cut-and-pasting, you can find it at <ulink
106 url="&files-anduin;/firefox-&firefox-version;-mozconfig"/>
107 (the file must be installed in the root of the source tree
108 <filename class='directory'>mozilla</filename> directory, and named
109 <filename>.mozconfig</filename>). Create the file by issuing the following
110 command:</para>
111
112<screen><userinput>cat &gt; .mozconfig &lt;&lt; "EOF"
113<literal># This file contains the options used in the Firefox build. You may
114# need to specify additional options for your specific build needs.
115# Use the information provided by running './configure --help' to
116# help you determine if you need to add any additional options.
117# Some additional options can be added by uncommenting the examples
118# in this file or adding options by inserting a line containing
119# 'ac_add_options --some-option-you-need'.
120
121
122# Use the default settings specified in the source tree
123. $topsrcdir/browser/config/mozconfig
124
125# Create an object directory and specify to build the package in that
126# directory. If desired, modify the location of the object directory
127# to a directory inside the source tree by removing '../' from the
128# line below.
129mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../firefox-build
130
131# Specify the installation prefix. If you would prefer Firefox
132# installed in a different prefix, modify the line below to fit
133# your needs. You'll also need to modify some of the instructions in
134# the BLFS book to point to your desired prefix.
135ac_add_options --prefix=/usr
136
137# These options are used so that the Firefox binaries are linked to
138# the system-installed copies of the specified libraries instead of
139# the source tree code which may not be the most recent versions.
140ac_add_options --with-system-zlib
141ac_add_options --with-system-png
142ac_add_options --with-system-jpeg
143ac_add_options --enable-system-cairo
144
145# This option causes the installed binaries to have the official
146# Firefox name embedded in them. Due to license restrictions, you
147# may not distribute binaries created using this option.
148ac_add_options --enable-official-branding
149
150# This option is used to enable support for rendering SVG files in the
151# Firefox browser. Comment out the line to disable the option.
152ac_add_options --enable-svg
153
154# This option is used so that the debugging symbols are removed from
155# the installed binaries during the installation process. Comment out
156# this option if you may have a need to retain the debugging symbols
157# in the installed binaries. Note that this can substantially
158# increase the size of the installed binaries.
159ac_add_options --enable-strip
160
161# This option is added so that test libraries and programs are not
162# built. These would only be required for debugging purposes.
163ac_add_options --disable-tests
164
165# This option is added so that the Mozilla Installer program is not
166# built or installed. The program is not required for a BLFS
167# installation of Firefox.
168ac_add_options --disable-installer
169
170# This option is used to disable the a11y support in the Firefox
171# binaries. Comment out this option if you require a11y support.
172ac_add_options --disable-accessibility
173
174# This option is used to enable source tree included LDAP support in
175# the Firefox binaries.
176###################################################################
177#
178# NOTE: You must uncomment this option if there is any chance of
179# compiling the OpenOffice package from source code using this copy
180# of Firefox for your Mozilla support.
181#
182###################################################################
183#ac_add_options --enable-ldap
184
185# Uncomment this option if you desire support for dual-monitor
186# display of Firefox using the X-Window Xinerama libraries.
187#ac_add_options --enable-xinerama
188
189# These two options enable support for building Firefox with
190# system-installed versions of the Network Security Services (NSS)
191# and Netscape Portable Runtime (NSPR) libraries. Uncomment both
192# lines to enable support for system-installed NSS/NSPR.
193#ac_add_options --with-system-nss
194#ac_add_options --with-system-nspr
195
196# Complex scripts such as Thai can only be rendered in Firefox with the
197# help of Pango. This option significantly slows rendering, so only use
198# it if necessary.
199#ac_add_options --enable-pango
200
201# This option identifies the default binary directory of the Firefox
202# installation and is used to locate Firefox's installed files. This
203# option is not required for end-user browsing, and is only used for
204# development purposes.
205#ac_add_options --with-default-mozilla-five-home=/usr/lib/firefox-&firefox-version;</literal>
206
207EOF</userinput></screen>
208
209 <para>Compile <application>Firefox</application> by issuing the
210 following commands:</para>
211
212<screen><userinput>cat &gt;&gt; layout/build/Makefile.in &lt;&lt; "EOF" &amp;&amp;
213ifdef MOZ_ENABLE_CANVAS
214EXTRA_DSO_LDOPTS += $(XLDFLAGS) -lX11 -lXrender
215endif
216EOF
217sed -i "s/^ enum$/&amp; xptinfo_enum_1/" \
218 xpcom/reflect/xptinfo/public/xptinfo.h &amp;&amp;
219make -f client.mk build</userinput></screen>
220
221 <para>This package does not come with a test suite.</para>
222
223 <para>Now, as the <systemitem class="username">root</systemitem> user,
224 install the package:</para>
225
226<screen role="root"><userinput>make -f client.mk install &amp;&amp;
227
228install -v -m755 -d /usr/lib/firefox-&firefox-version;/chrome/icons/default &amp;&amp;
229ln -v -s ../../../icons/default.xpm \
230 /usr/lib/firefox-&firefox-version;/chrome/icons/default &amp;&amp;
231
232chown -v -R root:root \
233 /usr/lib/firefox-&firefox-version;/extensions/inspector@mozilla.org/*</userinput></screen>
234
235 <para>If you enabled LDAP support in the <application>Firefox</application>
236 build, install some additional interface headers as the
237 <systemitem class="username">root</systemitem> user:</para>
238
239<screen role="root"><userinput>install -v -m644 ../firefox-build/dist/public/ldap-private/* \
240 /usr/include/firefox-&firefox-version;/ldap</userinput></screen>
241
242 <para>If you built <application>Firefox</application> utilizing
243 system-installed NSS and NSPR libraries, the
244 <filename>firefox-ns*.pc</filename> <application>pkgconfig</application>
245 files are broken as they point to the wrong directories where the actual
246 libraries and interface headers are located. Issue the following commands
247 as the <systemitem class="username">root</systemitem> user to replace the
248 broken files with symbolic links to known good files:</para>
249
250<screen role="root"><userinput>ln -v -sf nss.pc /usr/lib/pkgconfig/firefox-nss.pc &amp;&amp;
251ln -v -sf nspr.pc /usr/lib/pkgconfig/firefox-nspr.pc</userinput></screen>
252
253 <para>If you did <emphasis role="strong">NOT</emphasis> build
254 <application>Firefox</application> utilizing system-installed NSS and
255 NSPR libraries, issue the following commands as the
256 <systemitem class="username">root</systemitem> user to install the NSS
257 interface headers:</para>
258
259<screen role="root"><userinput>install -v -m755 -d /usr/include/firefox-&firefox-version;/nss &amp;&amp;
260cp -v -Lf ../firefox-build/dist/{private,public}/nss/*.h \
261 /usr/include/firefox-&firefox-version;/nss</userinput></screen>
262
263 <note>
264 <para>You should run <command>/usr/bin/firefox</command> once as the
265 <systemitem class="username">root</systemitem> user (or any user with
266 write privileges) to create some necessary additional files in the
267 <filename class='directory'>/usr</filename> hierarchy.</para>
268 </note>
269
270 </sect2>
271
272 <sect2 role="commands">
273 <title>Command Explanations</title>
274
275 <para><command>'EXTRA_DSO_LDOPTS' += -lX11 -lXrender ...</command>:
276 Building the layout backend will break when the canvas element is enabled
277 without adding these two required libraries.</para>
278
279 <para><command>sed -i "s/^ enum$/&amp; xptinfo_enum_1/" ...</command>:
280 This command is used to fix an anonymous enum in an external/public
281 interface header file.</para>
282
283 <para><command>make -f client.mk ...</command>: Mozilla products are
284 packaged to allow the use of a configuration file which can be used to
285 pass the configuration settings to the <command>configure</command>
286 command. <command>make</command> uses the <filename>client.mk</filename>
287 file to get initial configuration and setup parameters, then depending on
288 the target parameter (<parameter>build</parameter> or
289 <parameter>install</parameter>), either runs the
290 <command>configure</command> script and compiles the package or installs
291 the package.</para>
292
293 <para><command>install -v -m755 -d .../chrome/icons/default</command> and
294 <command>ln -v -s ../../../icons/default.xpm ...</command>: These two
295 commands are used to create a symlink in the required directory so that
296 the proper icon is displayed in the taskbar and when
297 <application>Firefox</application> windows are minimized.</para>
298
299 <para><command>chown -v -R root:root ...</command>: This command changes
300 the ownership of some installed files to more appropriate user:group
301 names.</para>
302
303 </sect2>
304
305 <sect2 role="configuration">
306 <title>Configuring Firefox</title>
307
308 <para>No specific configuration is required as long as the
309 <command>firefox</command> script is in the user's path. If
310 <application>Firefox</application> is installed in a non-standard location,
311 then make a symlink to the <command>firefox</command> script in the
312 <filename class="directory">/usr/bin</filename> directory.</para>
313
314 <para>If your Window or Desktop Manager does not allow you to configure
315 a default mail client, you can add a configuration parameter to
316 <application>Firefox</application> so that an email client will start
317 when you click on a <systemitem role='url'>mailto:</systemitem> URL.
318 There are two parameters you need to check. The procedure to check or
319 modify any of the configuration parameters is quite simple and the
320 instructions here can be used to view or modify any of the
321 parameters.</para>
322
323 <para>First, open the configuration dialog by entering
324 <systemitem role='url'>about:config</systemitem> in the address bar. This
325 will display a list of the configuration preferences and information
326 related to each one. You can use the <quote>Filter:</quote> bar to enter
327 search criteria and narrow down the listed items. Changing a preference
328 can be done using two methods. One, if the preference has a boolean value
329 (True/False), simply double-click on the preference to toggle the value
330 and two, for other preferences simply right-click on the desired line,
331 choose <quote>Modify</quote> from the menu and change the value. Creating
332 new preference items is accomplished in the same way, except choose
333 <quote>New</quote> from the menu and provide the desired data into the
334 fields when prompted.</para>
335
336 <para>The two configuration preference items you need to check so that
337 <application>Firefox</application> uses a specified default mail client
338 are the <parameter>network.protocol-handler.external.mailto</parameter>
339 which should be set to <option>True</option> and the
340 <parameter>network.protocol-handler.app.mailto</parameter> which should
341 be set to the path of the desired mail client, e.g.,
342 <option>/usr/bin/thunderbird</option>.</para>
343
344 <tip>
345 <para>There is a multitude of configuration parameters you can tweak to
346 customize <application>Firefox</application>. A very extensive and
347 up-to-date list of these parameters can be found at <ulink
348 url="http://preferential.mozdev.org/preferences.html"/>.</para>
349 </tip>
350
351 <para>Many applications look for <command>netscape</command> when they
352 need to open a browser. You may wish to make the following symlink for
353 convenience (as the <systemitem class="username">root</systemitem>
354 user).</para>
355
356<screen role="root"><userinput>ln -v -sf firefox /usr/bin/netscape</userinput></screen>
357
358 <para>For installing various <application>Firefox</application> plugins,
359 refer to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's
360 PluginDoc Project</ulink>. If you have the <xref linkend="jdk"/> already
361 installed, create the following link as the
362 <systemitem class="username">root</systemitem> user to utilize the installed
363 <application>Java</application> plugin: </para>
364
365<screen role="root"><userinput>ln -v -s $JAVA_HOME/jre/plugin/i386/ns7/libjavaplugin_oji.so \
366 /usr/lib/firefox-&firefox-version;/plugins</userinput></screen>
367
368 <para>Some packages install Mozilla plugins into the default system-wide
369 directory <filename class='directory'>/usr/lib/mozilla/plugins</filename>.
370 If desired, create symbolic links in the <application>Firefox</application>
371 plugin directory
372 <filename class='directory'>/usr/lib/firefox-&firefox-version;/plugins</filename>
373 to the files in the default plugin directory (you should link to the actual
374 files and not other links). Alternatively, you can move or copy the files
375 in the default plugin directory to the
376 <application>Firefox</application> plugin directory. An example of creating
377 a symbolic link is shown below. Create the links as the
378 <systemitem class="username">root</systemitem> user:</para>
379
380<screen role="root"><userinput>ln -v -s ../../mozilla/plugins/<replaceable>&lt;plugin.so&gt;</replaceable> \
381 /usr/lib/firefox-&firefox-version;/plugins</userinput></screen>
382
383 </sect2>
384
385 <sect2 role="content">
386 <title>Contents</title>
387
388 <segmentedlist>
389 <segtitle>Installed Programs</segtitle>
390 <segtitle>Installed Libraries</segtitle>
391 <segtitle>Installed Directories</segtitle>
392
393 <seglistitem>
394 <seg>firefox and firefox-config</seg>
395 <seg>Numerous libraries, browser components, plugins, extensions, and
396 helper modules installed in <filename
397 class='directory'>/usr/lib/firefox-&firefox-version;</filename></seg>
398 <seg>/usr/include/firefox-&firefox-version;,
399 /usr/lib/firefox-&firefox-version;, and
400 /usr/share/idl/firefox-&firefox-version;</seg>
401 </seglistitem>
402 </segmentedlist>
403
404 <variablelist>
405 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
406 <?dbfo list-presentation="list"?>
407 <?dbhtml list-presentation="table"?>
408
409 <varlistentry id="firefox-prog">
410 <term><command>firefox</command></term>
411 <listitem>
412 <para>is a shell script that sets up the environment and
413 calls the <filename>firefox-bin</filename> binary.</para>
414 <indexterm zone="firefox firefox-prog">
415 <primary sortas="b-firefox">firefox</primary>
416 </indexterm>
417 </listitem>
418 </varlistentry>
419
420 <varlistentry id="firefox-config">
421 <term><command>firefox-config</command></term>
422 <listitem>
423 <para>determines the compile and linker flags that should be
424 used to compile and link programs that use
425 <application>Firefox</application> libraries and browser
426 components.</para>
427 <indexterm zone="firefox firefox-config">
428 <primary sortas="b-firefox-config">firefox-config</primary>
429 </indexterm>
430 </listitem>
431 </varlistentry>
432
433 </variablelist>
434
435 </sect2>
436
437</sect1>
Note: See TracBrowser for help on using the repository browser.