source: x/lib/xulrunner.xml@ 87068b5

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 87068b5 was 87068b5, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Move deprecated gnome packages and gnucash to the archive.

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

  • Property mode set to 100644
File size: 10.8 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
8 "http://releases.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
9 <!ENTITY xulrunner-download-ftp
10 "ftp://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
11 <!ENTITY xulrunner-md5sum "4ffb6d1c1a04ca8e3dbca23df09626dd">
12 <!ENTITY xulrunner-size "107 MB">
13 <!ENTITY xulrunner-buildsize "4.4 GB (87 MB installed)">
14 <!ENTITY xulrunner-time "32 SBU">
15]>
16
17<sect1 id="xulrunner" xreflabel="Xulrunner-&xulrunner-version;">
18 <?dbhtml filename="xulrunner.html" ?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Xulrunner-&xulrunner-version;</title>
26
27 <indexterm zone="xulrunner">
28 <primary sortas="a-Xulrunner">Xulrunner</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Xulrunner</title>
33
34 <para>
35 <application>Xulrunner</application> is a runtime environment for XUL
36 applications, and forms the major part of the
37 <application>Mozilla</application> codebase. In particular, it provides
38 the Gecko engine together with pkgconfig files so that other applications
39 can find and use it.
40 </para>
41
42 &lfs73_checked;
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>
48 Download (HTTP): <ulink url="&xulrunner-download-http;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download (FTP): <ulink url="&xulrunner-download-ftp;"/>
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download MD5 sum: &xulrunner-md5sum;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Download size: &xulrunner-size;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated disk space required: &xulrunner-buildsize;
69 </para>
70 </listitem>
71 <listitem>
72 <para>
73 Estimated build time: &xulrunner-time;
74 </para>
75 </listitem>
76 </itemizedlist>
77
78 <bridgehead renderas="sect3">Xulrunner 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="libevent"/>,
91 <xref linkend="libvpx"/>,
92 <xref linkend="nspr"/>,
93 <xref linkend="nss"/>,
94 <xref linkend="sqlite"/> and
95 <xref linkend="yasm"/>
96 </para>
97
98 <note>
99 <para>
100 If you don't install recommended dependencies,
101 then internal copies of those packages will
102 be used. They might be tested to work, but
103 they can be out of date or contain security
104 holes.
105 </para>
106 </note>
107
108 <bridgehead renderas="sect4">Optional</bridgehead>
109 <para role="optional">
110 <xref linkend="curl"/>,
111 <xref linkend="dbus-glib"/>,
112 <xref linkend="doxygen"/>,
113 <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
114 <xref linkend="libnotify"/>,
115 <xref linkend="startup-notification"/>,
116 <xref linkend="wget"/> and
117 <xref linkend="wireless_tools"/>
118 </para>
119
120 <para condition="html" role="usernotes">
121 User Notes: <ulink url="&blfs-wiki;/xulrunner"/>
122 </para>
123 </sect2>
124
125 <sect2 role="installation">
126 <title>Installation of Xulrunner</title>
127
128 <para>
129 The configuration of <application>Xulrunner</application> is accomplished
130 by creating a <filename>mozconfig</filename> file containing the desired
131 configuration options. A default <filename>mozconfig</filename> is created
132 below. To see the entire list of available configuration options (and an
133 abbreviated description of each one), issue <command>./configure
134 --help</command>. You should review the entire file and comment or
135 uncomment options as necessary.
136 </para>
137
138<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
139# If you have a multicore machine, firefox will now use all the cores by
140# default. Exceptionally, you can reduce the number of cores, e.g. to 1,
141# by uncommenting the next line and setting a valid number of CPU cores.
142#mk_add_options MOZ_MAKE_FLAGS="-j1"
143
144# If you have installed DBus-Glib comment out this line:
145ac_add_options --disable-dbus
146
147# If you have installed wireless-tools comment out this line:
148ac_add_options --disable-necko-wifi
149
150# If you have installed libnotify comment out this line:
151ac_add_options --disable-libnotify
152
153# Uncomment these lines if you have installed optional dependencies:
154#ac_add_options --enable-system-hunspell
155#ac_add_options --enable-startup-notification
156
157# If you have not installed Yasm then uncomment this line:
158#ac_add_options --disable-webm
159
160# Comment out following options if you have not installed
161# recommended dependencies:
162ac_add_options --enable-system-sqlite
163ac_add_options --with-system-libevent
164ac_add_options --with-system-libvpx
165ac_add_options --with-system-nspr
166ac_add_options --with-system-nss
167
168# It is recommended not to touch anything below this line
169ac_add_options --prefix=/usr
170ac_add_options --enable-application=xulrunner
171
172ac_add_options --disable-crashreporter
173ac_add_options --disable-installer
174ac_add_options --disable-updater
175ac_add_options --disable-debug
176ac_add_options --disable-tests
177ac_add_options --disable-mochitest
178
179ac_add_options --enable-optimize
180ac_add_options --enable-strip
181ac_add_options --enable-install-strip
182
183ac_add_options --enable-system-ffi
184ac_add_options --enable-system-pixman
185
186ac_add_options --enable-shared-js
187ac_add_options --with-pthreads
188
189ac_add_options --with-system-bz2
190ac_add_options --with-system-jpeg
191ac_add_options --with-system-png
192ac_add_options --with-system-zlib
193
194mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/xulrunner-build-dir
195EOF</userinput></screen>
196
197 <para>
198 Install <application>Xulrunner</application> by issuing the following
199 commands:
200 </para>
201
202<screen><userinput>make -f client.mk</userinput></screen>
203
204 <para>
205 This package does not come with a test suite.
206 </para>
207
208 <para>
209 Now, as the <systemitem class="username">root</systemitem> user:
210 </para>
211
212<screen role="root"><userinput>make -C xulrunner-build-dir install &amp;&amp;
213
214mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
215rm -rf /usr/lib/xulrunner-&xulrunner-version;/plugins &amp;&amp;
216ln -sv ../mozilla/plugins /usr/lib/xulrunner-&xulrunner-version; &amp;&amp;
217
218chmod -v 755 /usr/lib/xulrunner-devel-&xulrunner-version;/sdk/bin/xpcshell &amp;&amp;
219
220for library in libmozalloc.so libmozjs.so libxul.so; do
221 ln -sfv ../../../xulrunner-&xulrunner-version;/$library \
222 /usr/lib/xulrunner-devel-&xulrunner-version;/sdk/lib/$library
223 ln -sfv xulrunner-&xulrunner-version;/$library /usr/lib/$library
224done
225
226ln -sfv ../xulrunner-devel-&xulrunner-version;/sdk/bin/run-mozilla.sh \
227 /usr/lib/xulrunner-&xulrunner-version;
228ln -sfv ../xulrunner-devel-&xulrunner-version;/sdk/bin/xpcshell \
229 /usr/lib/xulrunner-&xulrunner-version;</userinput></screen>
230
231 </sect2>
232
233 <sect2 role="commands">
234 <title>Command Explanations</title>
235
236 <para>
237 <command>make -f client.mk ...</command>: Mozilla products are packaged to
238 allow the use of a configuration file which can be used to pass the
239 configuration settings to the <command>configure</command> command.
240 <command>make</command> uses the <filename>client.mk</filename> file to
241 get initial configuration and setup parameters.
242 </para>
243
244 <para>
245 <command>ln -sfv ../mozilla/plugins ...</command>: Some packages will
246 install browser plugins into
247 <filename class="directory">/usr/lib/mozilla/plugins</filename>.
248 Creating this symlink <application>Xulrunner</application> keeps
249 additional plugins in a common directory.
250 </para>
251
252 <para>
253 <command>for library in libmozalloc.so libmozjs.so libxul.so ...
254 </command>: The libraries shipped with this package are installed into
255 <filename class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename>
256 which means they will not be found at runtime. These commands make
257 relative symbolic links to the shared libraries from
258 <filename class="directory">/usr/lib</filename>. They will also replace duplicate
259 libraries that are installed in
260 <filename class="directory">/usr/lib/xulrunner-devel-&xulrunner-version;/sdk/lib</filename>
261 with symlinks in order to save some space.
262 </para>
263
264 <para>
265 <command>ln -sfv ../xulrunner-devel-&xulrunner-version;/sdk/bin/ ...</command>
266 The <filename>run-mozilla.sh</filename> and <filename>xpcshell</filename> files
267 have been moved in this version, but the code which installs
268 <application>Firefox</application> (when linked to xulrunner) was not updated.
269 These symlinks allow<application>Firefox</application> to install when built against
270 <application>Xulrunner</application>.
271 </para>
272
273 </sect2>
274
275 <sect2 role="content">
276 <title>Contents</title>
277
278 <segmentedlist>
279 <segtitle>Installed Programs</segtitle>
280 <segtitle>Installed Libraries</segtitle>
281 <segtitle>Installed Directories</segtitle>
282
283 <seglistitem>
284 <seg>
285 xulrunner
286 </seg>
287 <seg>
288 Numerous libraries, browser components, plugins, extensions, and
289 helper modules installed in <filename
290 class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename>
291 </seg>
292 <seg>
293 /usr/include/xulrunner-&xulrunner-version;,
294 /usr/lib/xulrunner-&xulrunner-version;,
295 /usr/lib/xulrunner-devel-&xulrunner-version; and
296 /usr/share/idl/xulrunner-&xulrunner-version;
297 </seg>
298 </seglistitem>
299 </segmentedlist>
300
301 <variablelist>
302 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
303 <?dbfo list-presentation="list"?>
304 <?dbhtml list-presentation="table"?>
305
306 <varlistentry id="xulrunner-prog">
307 <term><command>xulrunner</command></term>
308 <listitem>
309 <para>
310 is a shell script used for identifying the installed version
311 and running <application>Xulrunner</application> applications.
312 </para>
313 <indexterm zone="xulrunner xulrunner-prog">
314 <primary sortas="b-xulrunner">xulrunner</primary>
315 </indexterm>
316 </listitem>
317 </varlistentry>
318
319 </variablelist>
320
321 </sect2>
322
323</sect1>
Note: See TracBrowser for help on using the repository browser.