source: x/lib/xulrunner.xml@ e305fa83

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since e305fa83 was e305fa83, checked in by Andrew Benton <andy@…>, 12 years ago

Added --enable-64bit to the nspr page

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

  • Property mode set to 100644
File size: 17.4 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 xulrunner-download-http "http://releases.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
8 <!ENTITY xulrunner-download-ftp "ftp://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
9 <!-- md5sum and size should match firefox, but the buildsize and time will differ -->
10 <!ENTITY xulrunner-md5sum "d7c90aed8209beefa74badf02e8eeae1">
11 <!ENTITY xulrunner-size "51 MB">
12 <!ENTITY xulrunner-buildsize "820 MB">
13 <!ENTITY xulrunner-time "20 SBU">
14]>
15
16<sect1 id="xulrunner" xreflabel="Xulrunner-&xulrunner-version;">
17 <?dbhtml filename="xulrunner.html" ?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Xulrunner-&xulrunner-version;</title>
25
26 <indexterm zone="xulrunner">
27 <primary sortas="a-Xulrunner">Xulrunner</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Xulrunner</title>
32
33 <!-- If someone updates this, please update the bit on the Firefox page
34 about building Firefox against xulrunner -->
35
36 <para><application>Xulrunner</application> is a runtime environment for XUL
37 applications, and forms the major part of the <application>Mozilla</application>
38 codebase. In particular, it provides the gecko engine together with pkgconfig
39 files so that applications such as <application>Yelp</application> can find
40 and use it. However, be aware that Gnome applications are transitioning to
41 <application>Webkit</application> instead of gecko.</para>
42
43 &lfs67_checked;
44 <para>&lfssvn_checked;20101029&lfssvn_checked2;</para>
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>Download (HTTP): <ulink url="&xulrunner-download-http;"/></para>
50 </listitem>
51 <listitem>
52 <para>Download (FTP): <ulink url="&xulrunner-download-ftp;"/></para>
53 <tip><para>When a new version of <application>Firefox</application> is
54 released, sometimes a corresponding new version of
55 <application>Xulrunner</application> appears at the same time. At other
56 times it appears several days later or not at all. So far in the
57 <application>Firefox-3.x</application> series, every new release has
58 created xulrunner libraries with a corresponding new version. Whenever
59 a separate Xulrunner tarball has been released, it has been bitwise
60 identical to the corresponding Firefox tarball. Use the
61 <application>Firefox</application> tarball to save downloading this
62 large package twice.</para></tip>
63 </listitem>
64 <listitem>
65 <para>Download MD5 sum: &xulrunner-md5sum;</para>
66 </listitem>
67 <listitem>
68 <para>Download size: &xulrunner-size;</para>
69 </listitem>
70 <listitem>
71 <para>Estimated disk space required: &xulrunner-buildsize; (using
72 all dependencies)</para>
73 </listitem>
74 <listitem>
75 <para>Estimated build time: &xulrunner-time; (using all
76 dependencies)</para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
81 <itemizedlist spacing="compact">
82 <listitem>
83 <para>Optional patch: <ulink
84 url="&patch-root;/firefox-&firefox-version;-provide_system_nspr_nss-1.patch"/>
85 (Required if using the included NSPR and NSS libraries as system versions for
86 other packages)</para>
87 </listitem>
88 </itemizedlist>
89
90 <bridgehead renderas="sect3">Xulrunner Dependencies</bridgehead>
91
92 <bridgehead renderas="sect4">Required</bridgehead>
93 <para role="required"><xref linkend="alsa-lib"/>,
94 <xref linkend="gtk2"/>,
95 <xref linkend="libidl"/>,
96 <xref linkend="pango"/>,
97 <xref linkend="python"/>, and
98 <xref linkend="zip"/></para>
99
100 <para>Note: <application>libjpeg</application> should have been installed
101 before <application>GTK+</application> and should exist on your system. If
102 for some reason you haven't installed <application>libjpeg</application>,
103 you should remove the <option>--with-system-jpeg</option> option from the
104 <filename>mozconfig</filename> file created below.</para>
105
106 <bridgehead renderas="sect4">Recommended</bridgehead>
107 <para role="recommended"><xref linkend="sqlite"/> (internal sqlite is
108 incompatable with existing or future installations)</para>
109
110 <bridgehead renderas="sect4">Optional</bridgehead>
111 <para role="optional"><xref linkend="dbus-glib"/>,
112 <xref linkend="doxygen"/>,
113 <xref linkend="curl"/> (only for crash-reporter),
114 <xref linkend="gnome-vfs"/> and <xref linkend="libgnomeui"/> (for gnome integration),
115 <xref linkend="libnotify"/>,
116 <xref linkend="libpng"/> (patched for apng support),
117 <xref linkend="nss"/> (recommended if you build any other Mozilla.org packages),
118 <xref linkend="startup-notification"/>,
119 <xref linkend="unzip"/>,
120 <ulink url="http://sourceforge.net/projects/hunspell/">Hunspell</ulink>,
121 <ulink url="http://www.valgrind.org/">Valgrind</ulink> (only for testing the jemalloc code), and
122 <xref linkend="wget"/></para>
123
124 <para condition="html" role="usernotes">User Notes:
125 <ulink url="&blfs-wiki;/xulrunner"/></para>
126
127 </sect2>
128
129 <sect2 role="installation">
130 <title>Installation of Xulrunner</title>
131
132 <para>The configuration of <application>Xulrunner</application> is
133 accomplished by creating a <filename>mozconfig</filename> file containing
134 the desired configuration options. A default <filename>mozconfig</filename>
135 is created below. To see the entire list of available configuration options
136 (and an abbreviated description of each one), issue
137 <command>./configure --help</command>. You should review the entire file
138 and comment or uncomment options as necessary. If you would prefer to
139 download the file instead of creating it by typing or cut-and-pasting, you
140 can find it at
141 <ulink url="&files-anduin;/xulrunner-&xulrunner-version;-mozconfig"/>
142 (the file must be installed in the root of the source tree, and named
143 <filename>mozconfig</filename> or <filename>.mozconfig</filename>).</para>
144
145<screen><?dbfo keep-together="auto"?><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
146<literal># This file contains the options used in the Xulrunner build. You may
147# need to specify additional options for your specific build needs.
148# Use the information provided by running './configure --help' to
149# help you determine if you need to add any additional options.
150# Some additional options can be added by uncommenting the examples
151# in this file or adding options by inserting a line containing
152# 'ac_add_options --some-option-you-need'. Be aware that some accepted
153# options, such as '--with-system-bz2', do not affect the build.
154
155# Specify that Xulrunner should be built. Note that this line is commented out
156# because it is redundant with the next setting.
157#ac_add_options --enable-application=xulrunner
158
159# Use the default settings specified in the source tree. The
160# --enable-application=xulrunner is set in this file.
161. $topsrcdir/xulrunner/config/mozconfig
162
163# Create an object directory and specify to build the package in that
164# directory. If desired, modify the location of the object directory
165# to a directory inside the source tree by removing '../' from the
166# line below.
167mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../xulrunner-build
168
169# Specify the installation prefix. If you would prefer Xulrunner installed in a
170# different prefix, modify the line below to fit your needs (the system.conf
171# configuration file will always be installed to /etc/gre.d).
172ac_add_options --prefix=/usr
173
174# Apply a minimal level of optimization (-O).
175ac_add_options --enable-optimize
176
177# These options are used so that the Xulrunner binaries are linked to
178# the system-installed copies of the specified libraries instead of
179# the source tree code which may not be the most recent versions.
180# With the exception of libsqlite3, the libraries are statically linked.
181
182# (Options to use system installed libraries)
183# Using the shipped version of libsqlite3 has been reported to cause
184# problems with other applications which were using sqlite3.
185# Only comment this line if you know exactly what you are doing!
186ac_add_options --enable-system-sqlite
187
188# Comment this only if you want to use whatever patched version of cairo
189# is in the shipped mozilla tree, together with the system headers.
190ac_add_options --enable-system-cairo
191
192# Comment this if you have not installed lcms.
193ac_add_options --enable-system-lcms
194
195# Uncomment this if you have installed Hunspell
196#ac_add_options --enable-system-hunspell
197
198# Uncomment this if you have installed startup-notification
199#ac_add_options --enable-startup-notification
200
201# Comment this if you did not build libjpeg before GTK+-2.
202ac_add_options --with-system-jpeg
203
204# These two options enable support for building Xulrunner with
205# system-installed versions of the Network Security Services (NSS)
206# and Netscape Portable Runtime (NSPR) libraries. Comment them if
207# you wish to use the included copies (not recommended).
208ac_add_options --with-system-nspr
209ac_add_options --with-system-nss
210
211# Comment this if you have not built png with the apng patch.
212ac_add_options --with-system-png
213
214# The pthreads option is only used when building nspr
215# Uncomment this if you build the included nspr.
216#ac_add_options --with-pthreads
217
218# Zlib is included in LFS. Do not comment this line.
219ac_add_options --with-system-zlib
220
221# (Options to disable parts of the package)
222# This option is used to disable the a11y support in the Xulrunner
223# binaries. Comment out this option if you require a11y support.
224ac_add_options --disable-accessibility
225
226# Uncomment this if you did not build cURL.
227#ac_add_options --disable-crashreporter
228
229# Comment this if you have built DBus-Glib.
230ac_add_options --disable-dbus
231
232# Comment this if you have Gnome-VFS and libgnomeui, and wish to
233# integrate Xulrunner into your Gnome desktop.
234ac_add_options --disable-gnomevfs
235
236# Comment this if you have wireless-tools installed and wish to use the new
237# Necko WiFi scanning.
238ac_add_options --disable-necko-wifi
239
240# Comment this if you have installed libnotify.
241ac_add_options --disable-libnotify
242
243# This option is added so that the Mozilla Installer program is not
244# built or installed. The program is not required for a BLFS
245# installation of Xulrunner.
246ac_add_options --disable-installer
247
248# If you enable javaxpcom, you must have a java compiler installed.
249ac_add_options --disable-javaxpcom
250
251# This option is added so that test libraries and programs are not
252# built. These would only be required for debugging purposes.
253ac_add_options --disable-tests
254
255# Disable the updater, which is not appropriate if you build from source.
256ac_add_options --disable-updater
257
258# (options to add extra parts of the package)
259# This option causes the installed Firefox binaries to have the official
260# Firefox name embedded in them. Due to license restrictions, you
261# may not distribute binaries created using this option. It also
262# means you get a popup EULA when you first run a Xulrunner Gecko engined
263# application.
264ac_add_options --enable-official-branding
265
266# Use the anti-phishing measures (a blacklist of sites).
267ac_add_options --enable-safe-browsing
268
269# This option is used so that the debugging symbols are removed from
270# the installed binaries during the installation process. Comment out
271# this option if you may have a need to retain the debugging symbols
272# in the installed binaries (the resulting binaries will be about 7MB
273# bigger).
274ac_add_options --enable-strip
275
276# Uncomment this option if you desire support for dual-monitor
277# display using the X-Window Xinerama libraries.
278#ac_add_options --enable-xinerama
279
280# This option identifies the default binary directory of the Xulrunner
281# installation and is used to locate Xulrunner's installed files. This
282# option is is only used for development purposes.
283#ac_add_options --with-default-mozilla-five-home=/usr/lib/xulrunner-&xulrunner-version;</literal>
284
285EOF</userinput></screen>
286
287 <para>If you did not install <xref linkend="nspr"/> and
288 <xref linkend="nss"/>, then apply the patch with the following
289 command:</para>
290
291<screen><userinput>patch -Np1 -i ../firefox-&firefox-version;-provide_system_nss_nspr-1.patch</userinput></screen>
292
293 <para>Install <application>Xulrunner</application> by issuing the
294 following commands:</para>
295
296<screen><userinput>echo "Requires: nspr" >>xulrunner/installer/libxul-embedding.pc.in &amp;&amp;
297make -f client.mk build</userinput></screen>
298
299 <para>This package does not come with a test suite.</para>
300
301 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
302
303<!-- I really don't think we need the last command to installl symlinks to the
304 Xul libraries. Any package using Xul is going to use the pkgconfig file to
305 find the things it needs -->
306<screen role="root"><userinput>make -f client.mk install &amp;&amp;
307
308install -v -m755 -d /usr/lib/mozilla &amp;&amp;
309ln -sv /usr/lib/xulrunner-&xulrunner-version;/plugins \
310 /usr/lib/mozilla &amp;&amp;
311
312chown -Rv root:root /usr/lib/xulrunner-* \
313 /usr/share/idl/xulrunner-&xulrunner-version; \
314 /usr/include/xulrunner-&xulrunner-version;</userinput></screen>
315
316<!-- commented out per discussion on BLFS-Dev
317ln -sfv xulrunner-devel-&xulrunner-version;/lib/lib{xul,xpcom,mozjs}.so \
318 /usr/lib</userinput></screen> -->
319
320 <para>If you elected to use the included NSPR and NSS, while still the
321 <systemitem class="username">root</systemitem> user, complete the
322 installation with the following commands:</para>
323
324<screen role="root"><userinput>for DL in \
325 libnss3.so libnssutil3.so libsmime3.so libssl3.so libsoftokn3.so \
326 libplds4.so libplc4.so libnspr4.so
327do
328 ln -sv xulrunner-&xulrunner-version;/$DL /usr/lib
329done &amp;&amp;
330unset DL</userinput></screen>
331
332 </sect2>
333
334 <sect2 role="commands">
335 <title>Command Explanations</title>
336
337 <para><command>echo "Requires: nspr"
338 >>xulrunner/installer/libxul-embedding.pc.in</command>: If you try to build
339 <application>Yelp</application> without this, the
340 prtypes header from NSPR will not be found. It is arguable whose error this
341 is (the code presumably works on earlier geckos), but this fix is unlikely
342 to cause any damage in other packages.</para>
343
344 <para><command>make -f client.mk ...</command>: Mozilla products are
345 packaged to allow the use of a configuration file which can be used to
346 pass the configuration settings to the <command>configure</command>
347 command. <command>make</command> uses the <filename>client.mk</filename>
348 file to get initial configuration and setup parameters, then depending on
349 the target parameter (<parameter>build</parameter> or
350 <parameter>install</parameter>), either runs the
351 <command>configure</command> script and compiles the package or installs
352 the package.</para>
353
354 <para><command>for DL in ...</command>: The NSPR and NSS libraries shipped
355 with this package are installed into
356 <filename class='directory'>/usr/lib/xulrunner-&xulrunner-version;</filename>
357 which means they will not be found at runtime. By using symbolic links from
358 <filename class="directory">/usr/lib</filename> the libraries will be found
359 and the links can be easily changed to point to a newer version during an
360 upgrade.</para>
361
362 <para><command>ln -sv /usr/lib/xulrunner-&xulrunner-version;/plugins
363 /usr/lib/mozilla</command>: Some packages will install browser plugins
364 into <filename class='directory'>/usr/lib/mozilla/plugins</filename>.
365 Creating this as a symlink to the <application>Xulrunner</application>
366 plugins keeps additional plugins in a common directory.</para>
367
368 <note>
369 <para>When you upgrade Xulrunner, remember to update the symlinks and to
370 copy any additional plugins compiled against this series of Xulrunner to the
371 new plugin directory.</para>
372 </note>
373
374 </sect2>
375
376 <sect2 role="content">
377 <title>Contents</title>
378
379 <segmentedlist>
380 <segtitle>Installed Programs</segtitle>
381 <segtitle>Installed Libraries</segtitle>
382 <segtitle>Installed Directories</segtitle>
383
384 <seglistitem>
385 <seg>xulrunner, and optionally nspr-config</seg>
386 <seg>Numerous libraries, browser components, plugins, extensions, and
387 helper modules installed in <filename
388 class='directory'>/usr/lib/xulrunner-&xulrunner-version;</filename></seg>
389 <seg>/etc/gre.d, /usr/include/xulrunner-&xulrunner-version;,
390 /usr/lib/xulrunner-&xulrunner-version;,
391 /usr/lib/xulrunner-devel-&xulrunner-version;, and
392 /usr/share/idl/xulrunner-&xulrunner-version;</seg>
393 </seglistitem>
394 </segmentedlist>
395
396 <variablelist>
397 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
398 <?dbfo list-presentation="list"?>
399 <?dbhtml list-presentation="table"?>
400
401 <varlistentry id="xulrunner-prog">
402 <term><command>xulrunner</command></term>
403 <listitem>
404 <para>is a shell script, useful for identifying the version
405 installed.</para>
406 <indexterm zone="xulrunner xulrunner-prog">
407 <primary sortas="b-xulrunner">xulrunner</primary>
408 </indexterm>
409 </listitem>
410 </varlistentry>
411
412 </variablelist>
413
414 </sect2>
415
416</sect1>
Note: See TracBrowser for help on using the repository browser.