source: archive/xulrunner.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 13.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 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-http
10 "http:///ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
11 <!ENTITY xulrunner-download-ftp
12 "ftp://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;.source.tar.bz2">
13 <!ENTITY xulrunner-md5sum "499b70a9f08a2291d528e87eaf8804a3">
14 <!ENTITY xulrunner-size "141 MB">
15 <!-- measured on LFS-7.5 x86_64 -->
16 <!ENTITY xulrunner-buildsize "4.9 GB (103 MB installed)">
17 <!ENTITY xulrunner-time "46 SBU">
18]>
19
20<sect1 id="xulrunner" xreflabel="Xulrunner-&xulrunner-version;">
21 <?dbhtml filename="xulrunner.html" ?>
22
23 <sect1info>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>Xulrunner-&xulrunner-version;</title>
28
29 <indexterm zone="xulrunner">
30 <primary sortas="a-Xulrunner">Xulrunner</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to Xulrunner</title>
35
36 <para>
37 <application>Xulrunner</application> is a runtime environment for XUL
38 applications, and forms the major part of the
39 <application>Mozilla</application> codebase. In particular, it provides
40 the Gecko engine together with pkgconfig files so that other applications
41 can find and use it.
42 </para>
43
44 &lfs75_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>
50 Download (HTTP): <ulink url="&xulrunner-download-http;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download (FTP): <ulink url="&xulrunner-download-ftp;"/>
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download MD5 sum: &xulrunner-md5sum;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download size: &xulrunner-size;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated disk space required: &xulrunner-buildsize;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Estimated build time: &xulrunner-time;
76 </para>
77 </listitem>
78 </itemizedlist>
79
80 <bridgehead renderas="sect3">Xulrunner Dependencies</bridgehead>
81
82 <bridgehead renderas="sect4">Required</bridgehead>
83 <para role="required">
84 <xref linkend="alsa-lib"/>,
85 <xref linkend="gtk2"/>,
86 <xref linkend="zip"/> and
87 <xref linkend="unzip"/>
88 </para>
89
90 <bridgehead renderas="sect4">Recommended</bridgehead>
91 <para role="recommended">
92 <xref linkend="icu"/>,
93 <xref linkend="libevent"/>,
94 <xref linkend="libvpx"/>,
95 <xref linkend="nspr"/>,
96 <xref linkend="nss"/>,
97 <xref linkend="sqlite"/> and
98 <xref linkend="yasm"/>
99 </para>
100
101 <note>
102 <para>
103 If you don't install recommended dependencies,
104 then internal copies of those packages will
105 be used. They might be tested to work, but
106 they can be out of date or contain security
107 holes.
108 </para>
109 </note>
110
111 <note>
112 <para>
113 With <application>Firefox-31.0</application> and later versions, you
114 must have installed <application>Openssl</application> before
115 <application>Python 2</application>, or the build system will quickly
116 fail with output including "ImportError: cannot import name
117 HTTPSHandler". If you are in any doubt about this (e.g. upgrading
118 from an older version of Xulrunner), check if
119 <filename>/usr/lib/python2.7/lib-dynload/_ssl.so</filename> exists.
120 If it does not, reinstall <xref linkend="python2"/> (after
121 installing <xref linkend="openssl"/> - the latest version of any
122 <emphasis>currently maintained</emphasis> version of Openssl should
123 be satisfactory if already installed - if that package has not already
124 been installed).
125 </para>
126 </note>
127
128 <bridgehead renderas="sect4">Optional</bridgehead>
129 <para role="optional">
130 <xref linkend="curl"/>,
131 <xref linkend="dbus-glib"/>,
132 <xref linkend="doxygen"/>,
133 <xref linkend="gst-plugins-base"/> (with
134 <xref linkend="gst-plugins-good"/> and
135 <xref linkend="gst-ffmpeg"/> at runtime), or
136 <xref linkend="gst10-plugins-base"/> (with
137 <xref linkend="gst10-plugins-good"/> and
138 <xref linkend="gst10-libav"/> at runtime),
139 <ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>,
140 <xref linkend="libnotify"/>,
141 <xref linkend="openjdk"/>,
142 <xref linkend="pulseaudio"/>,
143 <xref linkend="startup-notification"/>,
144 <xref linkend="wget"/> and
145 <xref linkend="wireless_tools"/>
146 </para>
147
148 <para condition="html" role="usernotes">
149 User Notes: <ulink url="&blfs-wiki;/xulrunner"/>
150 </para>
151 </sect2>
152
153 <sect2 role="installation">
154 <title>Installation of Xulrunner</title>
155
156 <para>
157 The configuration of <application>Xulrunner</application> is accomplished
158 by creating a <filename>mozconfig</filename> file containing the desired
159 configuration options. A default <filename>mozconfig</filename> is created
160 below. To see the entire list of available configuration options (and an
161 abbreviated description of each one), issue <command>./configure
162 --help</command>. You should review the entire file and comment or
163 uncomment options as necessary.
164 </para>
165
166<screen><userinput>cat &gt; mozconfig &lt;&lt; "EOF"
167# If you have a multicore machine, firefox will now use all the cores by
168# default. Exceptionally, you can reduce the number of cores, e.g. to 1,
169# by uncommenting the next line and setting a valid number of CPU cores.
170#mk_add_options MOZ_MAKE_FLAGS="-j1"
171
172# If you have installed DBus-Glib comment out this line:
173ac_add_options --disable-dbus
174
175# If you have installed dbus-glib, and you have installed (or will install)
176# wireless-tools, and you wish to use geolocation web services, comment out
177# this line
178ac_add_options --disable-necko-wifi
179
180# If you have installed libnotify comment out this line:
181ac_add_options --disable-libnotify
182
183# GStreamer is necessary for H.264 video playback in HTML5 Video Player;
184# to be enabled, also remember to set "media.gstreamer.enabled" to "true"
185# in about:config. If you have GStreamer 0.x.y, uncomment this line:
186#ac_add_options --enable-gstreamer
187# or uncomment this line, if you have GStreamer 1.x.y
188#ac_add_options --enable-gstreamer=1.0
189
190# Uncomment these lines if you have installed optional dependencies:
191#ac_add_options --enable-system-hunspell
192#ac_add_options --enable-startup-notification
193
194# Comment out following option if you have PulseAudio installed
195ac_add_options --disable-pulseaudio
196
197# If you have not installed Yasm then uncomment this line:
198#ac_add_options --disable-webm
199
200# Comment out following options if you have not installed
201# recommended dependencies:
202ac_add_options --enable-system-sqlite
203ac_add_options --with-system-libevent
204ac_add_options --with-system-libvpx
205ac_add_options --with-system-nspr
206ac_add_options --with-system-nss
207ac_add_options --with-system-icu
208
209# The BLFS editors recommend not changing anything below this line:
210ac_add_options --prefix=/usr
211ac_add_options --enable-application=xulrunner
212
213ac_add_options --disable-crashreporter
214ac_add_options --disable-updater
215ac_add_options --disable-tests
216
217ac_add_options --enable-optimize
218ac_add_options --enable-strip
219ac_add_options --enable-install-strip
220
221ac_add_options --enable-system-cairo
222ac_add_options --enable-system-ffi
223ac_add_options --enable-system-pixman
224
225ac_add_options --enable-shared-js
226ac_add_options --with-pthreads
227
228ac_add_options --with-system-bz2
229ac_add_options --with-system-jpeg
230ac_add_options --with-system-png
231ac_add_options --with-system-zlib
232
233mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/xulrunner-build-dir
234EOF</userinput></screen>
235
236 <note>
237 <para>
238 <application>Xulrunner</application>'s build uses large amount of
239 memory. On some systems, the RAM/Swap combination needs 6 GB available.
240 </para>
241 </note>
242
243 <para>
244 Build <application>Xulrunner</application> by issuing the following
245 commands:
246 </para>
247
248 <note><para>
249 If you are compiling <application>Xulrunner</application> in chroot,
250 prepend <envar>SHELL=/bin/bash</envar> to the first make command below.
251 </para></note>
252
253<screen><userinput>sed -i '/^template class/s/JS::WeakMapPtr/JS_PUBLIC_API(&amp;)/' \
254 js/src/vm/WeakMapPtr.cpp &amp;&amp;
255make -f client.mk</userinput></screen>
256
257 <para>
258 This package does not come with a test suite.
259 </para>
260
261 <para>
262 Install, as the <systemitem class="username">root</systemitem> user:
263 </para>
264
265<screen role="root"><userinput>make -C xulrunner-build-dir install &amp;&amp;
266
267mkdir -pv /usr/lib/mozilla/plugins &amp;&amp;
268rm -rf /usr/lib/xulrunner-&xulrunner-version;/plugins &amp;&amp;
269ln -sv ../mozilla/plugins /usr/lib/xulrunner-&xulrunner-version; &amp;&amp;
270
271chmod -v 755 /usr/lib/xulrunner-devel-&xulrunner-version;/sdk/bin/xpcshell &amp;&amp;
272
273for library in libmozalloc.so libmozjs.so libxul.so; do
274 ln -sfv ../../../xulrunner-&xulrunner-version;/$library \
275 /usr/lib/xulrunner-devel-&xulrunner-version;/sdk/lib/$library
276 ln -sfv xulrunner-&xulrunner-version;/$library /usr/lib/$library
277done
278
279ln -sfv ../xulrunner-devel-&xulrunner-version;/sdk/bin/run-mozilla.sh \
280 /usr/lib/xulrunner-&xulrunner-version;
281ln -sfv ../xulrunner-devel-&xulrunner-version;/sdk/bin/xpcshell \
282 /usr/lib/xulrunner-&xulrunner-version;</userinput></screen>
283
284 </sect2>
285
286 <sect2 role="commands">
287 <title>Command Explanations</title>
288
289 <para>
290 <command>sed -i ... js/src/vm/WeakMapPtr.cpp</command>: Fixes build with
291 <command>ac_add_options --enable-shared-js</command>.
292 </para>
293
294 <para>
295 <command>make -f client.mk ...</command>: Mozilla products are packaged to
296 allow the use of a configuration file which can be used to pass the
297 configuration settings to the <command>configure</command> command.
298 <command>make</command> uses the <filename>client.mk</filename> file to
299 get initial configuration and setup parameters.
300 </para>
301
302 <para>
303 <command>ln -sfv ../mozilla/plugins ...</command>: Some packages will
304 install browser plugins into
305 <filename class="directory">/usr/lib/mozilla/plugins</filename>.
306 Creating this symlink <application>Xulrunner</application> keeps
307 additional plugins in a common directory.
308 </para>
309
310 <para>
311 <command>for library in libmozalloc.so libmozjs.so libxul.so ...
312 </command>: The libraries shipped with this package are installed into
313 <filename class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename>
314 which means they will not be found at runtime. These commands make
315 relative symbolic links to the shared libraries from
316 <filename class="directory">/usr/lib</filename>. They will also replace duplicate
317 libraries that are installed in
318 <filename class="directory">/usr/lib/xulrunner-devel-&xulrunner-version;/sdk/lib</filename>
319 with symlinks in order to save some space.
320 </para>
321
322 <para>
323 <command>ln -sfv ../xulrunner-devel-&xulrunner-version;/sdk/bin/ ...</command>
324 The <filename>run-mozilla.sh</filename> and <filename>xpcshell</filename> files
325 have been moved in this version, but the code which installs
326 <application>Firefox</application> (when linked to xulrunner) was not updated.
327 These symlinks allow<application>Firefox</application> to install when built against
328 <application>Xulrunner</application>.
329 </para>
330
331 </sect2>
332
333 <sect2 role="content">
334 <title>Contents</title>
335
336 <segmentedlist>
337 <segtitle>Installed Programs</segtitle>
338 <segtitle>Installed Libraries</segtitle>
339 <segtitle>Installed Directories</segtitle>
340
341 <seglistitem>
342 <seg>
343 xulrunner
344 </seg>
345 <seg>
346 Numerous libraries, browser components, plugins, extensions, and
347 helper modules installed in <filename
348 class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename>
349 </seg>
350 <seg>
351 /usr/include/xulrunner-&xulrunner-version;,
352 /usr/lib/xulrunner-&xulrunner-version;,
353 /usr/lib/xulrunner-devel-&xulrunner-version; and
354 /usr/share/idl/xulrunner-&xulrunner-version;
355 </seg>
356 </seglistitem>
357 </segmentedlist>
358
359 <variablelist>
360 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
361 <?dbfo list-presentation="list"?>
362 <?dbhtml list-presentation="table"?>
363
364 <varlistentry id="xulrunner-prog">
365 <term><command>xulrunner</command></term>
366 <listitem>
367 <para>
368 is a shell script used for identifying the installed version
369 and running <application>Xulrunner</application> applications.
370 </para>
371 <indexterm zone="xulrunner xulrunner-prog">
372 <primary sortas="b-xulrunner">xulrunner</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 </variablelist>
378
379 </sect2>
380
381</sect1>
Note: See TracBrowser for help on using the repository browser.