source: x/lib/xulrunner.xml@ 38216f2

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 38216f2 was 38216f2, checked in by Andrew Benton <andy@…>, 10 years ago

typo

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

  • Property mode set to 100644
File size: 10.9 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 "7cf2bd379792a9b232267c6a79680566">
11 <!ENTITY xulrunner-size "70.8 MB">
12 <!ENTITY xulrunner-buildsize "2.6 GB (440 MB installed)">
13 <!ENTITY xulrunner-time "22 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 <para><application>Xulrunner</application> is a runtime environment for XUL
34 applications, and forms the major part of the
35 <application>Mozilla</application> codebase. In particular, it provides the
36 gecko engine together with pkgconfig files so that applications such as
37 <application>Yelp</application> can find and use it. However, be aware that
38 Gnome applications are transitioning to <application>Webkit</application>
39 instead of gecko.</para>
40
41 &lfs70_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>Download (HTTP): <ulink url="&xulrunner-download-http;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download (FTP): <ulink url="&xulrunner-download-ftp;"/></para>
50 </listitem>
51 <listitem>
52 <para>Download MD5 sum: &xulrunner-md5sum;</para>
53 </listitem>
54 <listitem>
55 <para>Download size: &xulrunner-size;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated disk space required: &xulrunner-buildsize;</para>
59 </listitem>
60 <listitem>
61 <para>Estimated build time: &xulrunner-time;</para>
62 </listitem>
63 </itemizedlist>
64
65 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
66 <itemizedlist spacing="compact">
67 <listitem>
68 <para>Required patch:
69 <ulink
70 url="&patch-root;/xulrunner-&xulrunner-version;-libpng-1.5-1.patch"/></para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Xulrunner Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required"><xref linkend="alsa-lib"/>, <xref linkend="gtk2"/>,
78 <xref linkend="libidl"/> and <xref linkend="zip"/></para>
79
80 <para>Note: <application>libjpeg</application> and
81 <application>libpng</application> (patched for apng support) should have
82 been installed before <application>gdk-pixbuf</application> and should
83 exist on your system. If for some strange reason you haven&apos;t installed
84 them, you should remove the <option>--with-system-jpeg</option> and
85 <option>--with-system-png</option> options from the
86 <filename>mozconfig</filename> file created below.</para>
87
88 <bridgehead renderas="sect4">Recommended</bridgehead>
89 <para role="recommended"><xref linkend="yasm"/> or
90 <xref linkend="libvpx"/>.</para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional"><xref linkend="dbus-glib"/>,
94 <xref linkend="startup-notification"/>, <xref linkend="sqlite"/>,
95 <ulink url="http://www.webmproject.org/code/">libvpx</ulink>,
96 <ulink url="http://sourceforge.net/projects/hunspell/">Hunspell</ulink>,
97 <ulink url="http://libevent.org/">Libevent</ulink>,
98 <xref linkend="doxygen"/>,
99 <xref linkend="gnome-vfs"/> and <xref linkend="libgnomeui"/> (for gnome
100 integration), <xref linkend="libnotify"/>, <xref linkend="nspr"/>,
101 <xref linkend="nss"/>, <xref linkend="unzip"/>,
102 <xref linkend="wireless_tools"/>,
103 <ulink url="http://www.valgrind.org/">Valgrind</ulink> (only for testing
104 the jemalloc code) and <xref linkend="wget"/></para>
105
106 <para condition="html" role="usernotes">User Notes:
107 <ulink url="&blfs-wiki;/xulrunner"/></para>
108
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of Xulrunner</title>
113
114 <para>The configuration of <application>Xulrunner</application> is
115 accomplished by creating a <filename>mozconfig</filename> file containing
116 the desired configuration options. A default <filename>mozconfig</filename>
117 is created below. To see the entire list of available configuration options
118 (and an abbreviated description of each one), issue
119 <command>./configure --help</command>. You should review the entire file
120 and comment or uncomment options as necessary.</para>
121
122<screen><?dbfo keep-together="auto"?><userinput>patch -p1 &lt; ../xulrunner-&xulrunner-version;-libpng-1.5-1.patch &amp;&amp;
123cat &gt; mozconfig &lt;&lt; "EOF"
124# If you have a multicore machine you can speed up the build by running
125# several jobs at once, but if you have a single core, delete this line:
126mk_add_options MOZ_MAKE_FLAGS="-j4"
127
128# If you have installed Yasm delete this option:
129ac_add_options --disable-webm
130
131# If you have installed DBus-Glib delete this option:
132ac_add_options --disable-dbus
133
134# If you have installed wireless-tools delete this option:
135ac_add_options --disable-necko-wifi
136
137# If you have installed libnotify delete this option:
138ac_add_options --disable-libnotify
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# ac_add_options --with-system-libevent
148
149mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/xulrunner-build-dir
150ac_add_options --prefix=/usr
151ac_add_options --enable-application=xulrunner
152ac_add_options --with-pthreads
153ac_add_options --enable-system-ffi
154ac_add_options --with-system-jpeg
155ac_add_options --with-system-png
156ac_add_options --enable-system-cairo
157ac_add_options --with-system-zlib
158ac_add_options --enable-shared
159ac_add_options --disable-static
160ac_add_options --disable-debug
161ac_add_options --disable-crashreporter
162ac_add_options --disable-installer
163ac_add_options --disable-updater
164ac_add_options --disable-tests
165EOF</userinput></screen>
166
167 <para>Install <application>Xulrunner</application> by issuing the
168 following commands:</para>
169
170<screen><userinput>sed -i '/Version/aRequires: nspr &gt;= &nspr-version;' xulrunner/installer/libxul-embedding.pc.in &amp;&amp;
171make -f client.mk</userinput></screen>
172
173 <para>This package does not come with a test suite.</para>
174
175 <para>Now, as the <systemitem class="username">root</systemitem>
176 user:</para>
177
178<screen role="root"><userinput>make -C xulrunner-build-dir install &amp;&amp;
179mkdir -p /usr/lib/mozilla &amp;&amp;
180rm -rf /usr/lib/xulrunner-&xulrunner-version;/plugins &amp;&amp;
181ln -sv ../mozilla/plugins /usr/lib/xulrunner-&xulrunner-version; &amp;&amp;
182chown -Rv root:root /usr/{include,lib,share/idl}/xulrunner-*</userinput></screen>
183
184 <para>If you elected to use the included NSPR and NSS (ie, if you have
185 <emphasis>not</emphasis> installed <xref linkend="nspr"/> and
186 <xref linkend="nss"/>), while still the
187 <systemitem class="username">root</systemitem> user, complete the
188 installation with the following commands:</para>
189
190<screen role="root"><userinput>for DL in libnss3.so libnssutil3.so libsmime3.so \
191 libssl3.so libsoftokn3.so libplds4.so libplc4.so libnspr4.so
192do ln -sv xulrunner-&xulrunner-version;/${DL} /usr/lib
193done &amp;&amp;
194unset DL</userinput></screen>
195
196 </sect2>
197
198 <sect2 role="commands">
199 <title>Command Explanations</title>
200
201 <para><command>sed ... Requires: nspr</command>: If you try to build
202 <application>Yelp</application> without this, the
203 prtypes header from NSPR will not be found. It is arguable whose error this
204 is (the code presumably works on earlier geckos), but this fix is unlikely
205 to cause any damage in other packages.</para>
206
207 <para><command>make -f client.mk ...</command>: Mozilla products are
208 packaged to allow the use of a configuration file which can be used to
209 pass the configuration settings to the <command>configure</command>
210 command. <command>make</command> uses the <filename>client.mk</filename>
211 file to get initial configuration and setup parameters.</para>
212
213 <para><command>for DL in ...</command>: The NSPR and NSS libraries shipped
214 with this package are installed into
215 <filename
216 class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename>
217 which means they will not be found at runtime. By using symbolic links
218 from <filename class="directory">/usr/lib</filename> the libraries will be
219 found and the links can be easily changed to point to a newer version
220 during an upgrade.</para>
221
222 <para><command>ln -sv ../mozilla/plugins ...</command>: Some packages will
223 install browser plugins into
224 <filename class="directory">/usr/lib/mozilla/plugins</filename>.
225 Creating this symlink <application>Xulrunner</application> keeps additional
226 plugins in a common directory.</para>
227
228 <note>
229 <para>When you upgrade Xulrunner, remember to update the symlinks.</para>
230 </note>
231
232 </sect2>
233
234 <sect2 role="content">
235 <title>Contents</title>
236
237 <segmentedlist>
238 <segtitle>Installed Programs</segtitle>
239 <segtitle>Installed Libraries</segtitle>
240 <segtitle>Installed Directories</segtitle>
241
242 <seglistitem>
243 <seg>xulrunner, and optionally nspr-config</seg>
244 <seg>Numerous libraries, browser components, plugins, extensions, and
245 helper modules installed in <filename
246 class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename></seg>
247 <seg>/etc/gre.d, /usr/include/xulrunner-&xulrunner-version;,
248 /usr/lib/xulrunner-&xulrunner-version;,
249 /usr/lib/xulrunner-devel-&xulrunner-version;, and
250 /usr/share/idl/xulrunner-&xulrunner-version;</seg>
251 </seglistitem>
252 </segmentedlist>
253
254 <variablelist>
255 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
256 <?dbfo list-presentation="list"?>
257 <?dbhtml list-presentation="table"?>
258
259 <varlistentry id="xulrunner-prog">
260 <term><command>xulrunner</command></term>
261 <listitem>
262 <para>is a shell script, useful for identifying the version
263 installed.</para>
264 <indexterm zone="xulrunner xulrunner-prog">
265 <primary sortas="b-xulrunner">xulrunner</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 </variablelist>
271
272 </sect2>
273
274</sect1>
Note: See TracBrowser for help on using the repository browser.