source: x/lib/xulrunner.xml@ 7133ec2

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

xulrunner needs to be patched to compile with libpng-1.5

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@9184 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;cat &gt; mozconfig &lt;&lt; "EOF"
123<literal># If you have a multicore machine you can speed up the build by running
124# several jobs at once, but if you have a single core, delete this line:
125mk_add_options MOZ_MAKE_FLAGS="-j4"
126
127# If you have installed Yasm delete this option:
128ac_add_options --disable-webm
129
130# If you have installed DBus-Glib delete this option:
131ac_add_options --disable-dbus
132
133# If you have installed wireless-tools delete this option:
134ac_add_options --disable-necko-wifi
135
136# If you have installed libnotify delete this option:
137ac_add_options --disable-libnotify
138
139# Uncomment these if you have installed them:
140# ac_add_options --with-system-nspr
141# ac_add_options --with-system-nss
142# ac_add_options --enable-system-sqlite
143# ac_add_options --with-system-libvpx
144# ac_add_options --enable-startup-notification
145# ac_add_options --enable-system-hunspell
146# ac_add_options --with-system-libevent
147
148mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/xulrunner-build-dir
149ac_add_options --prefix=/usr
150ac_add_options --enable-application=xulrunner
151ac_add_options --with-pthreads
152ac_add_options --enable-system-ffi
153ac_add_options --with-system-jpeg
154ac_add_options --with-system-png
155ac_add_options --enable-system-cairo
156ac_add_options --with-system-zlib
157ac_add_options --enable-shared
158ac_add_options --disable-static
159ac_add_options --disable-debug
160ac_add_options --disable-crashreporter
161ac_add_options --disable-installer
162ac_add_options --disable-updater
163ac_add_options --disable-tests</literal>
164EOF</userinput></screen>
165
166 <para>Install <application>Xulrunner</application> by issuing the
167 following commands:</para>
168
169<screen><userinput>sed -i '/Version/aRequires: nspr &gt;= &nspr-version;' xulrunner/installer/libxul-embedding.pc.in &amp;&amp;
170make -f client.mk</userinput></screen>
171
172 <para>This package does not come with a test suite.</para>
173
174 <para>Now, as the <systemitem class="username">root</systemitem>
175 user:</para>
176
177<screen role="root"><userinput>make -C xulrunner-build-dir install &amp;&amp;
178mkdir -p /usr/lib/mozilla &amp;&amp;
179rm -rf /usr/lib/xulrunner-&xulrunner-version;/plugins &amp;&amp;
180ln -sv ../mozilla/plugins /usr/lib/xulrunner-&xulrunner-version; &amp;&amp;
181chown -Rv root:root /usr/{include,lib,share/idl}/xulrunner-*</userinput></screen>
182
183 <para>If you elected to use the included NSPR and NSS (ie, if you have
184 <emphasis>not</emphasis> installed <xref linkend="nspr"/> and
185 <xref linkend="nss"/>), while still the
186 <systemitem class="username">root</systemitem> user, complete the
187 installation with the following commands:</para>
188
189<screen role="root"><userinput>for DL in libnss3.so libnssutil3.so libsmime3.so \
190 libssl3.so libsoftokn3.so libplds4.so libplc4.so libnspr4.so
191do ln -sv xulrunner-&xulrunner-version;/${DL} /usr/lib
192done &amp;&amp;
193unset DL</userinput></screen>
194
195 </sect2>
196
197 <sect2 role="commands">
198 <title>Command Explanations</title>
199
200 <para><command>sed ... Requires: nspr</command>: If you try to build
201 <application>Yelp</application> without this, the
202 prtypes header from NSPR will not be found. It is arguable whose error this
203 is (the code presumably works on earlier geckos), but this fix is unlikely
204 to cause any damage in other packages.</para>
205
206 <para><command>make -f client.mk ...</command>: Mozilla products are
207 packaged to allow the use of a configuration file which can be used to
208 pass the configuration settings to the <command>configure</command>
209 command. <command>make</command> uses the <filename>client.mk</filename>
210 file to get initial configuration and setup parameters.</para>
211
212 <para><command>for DL in ...</command>: The NSPR and NSS libraries shipped
213 with this package are installed into
214 <filename
215 class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename>
216 which means they will not be found at runtime. By using symbolic links
217 from <filename class="directory">/usr/lib</filename> the libraries will be
218 found and the links can be easily changed to point to a newer version
219 during an upgrade.</para>
220
221 <para><command>ln -sv ../mozilla/plugins ...</command>: Some packages will
222 install browser plugins into
223 <filename class="directory">/usr/lib/mozilla/plugins</filename>.
224 Creating this symlink <application>Xulrunner</application> keeps additional
225 plugins in a common directory.</para>
226
227 <note>
228 <para>When you upgrade Xulrunner, remember to update the symlinks.</para>
229 </note>
230
231 </sect2>
232
233 <sect2 role="content">
234 <title>Contents</title>
235
236 <segmentedlist>
237 <segtitle>Installed Programs</segtitle>
238 <segtitle>Installed Libraries</segtitle>
239 <segtitle>Installed Directories</segtitle>
240
241 <seglistitem>
242 <seg>xulrunner, and optionally nspr-config</seg>
243 <seg>Numerous libraries, browser components, plugins, extensions, and
244 helper modules installed in <filename
245 class="directory">/usr/lib/xulrunner-&xulrunner-version;</filename></seg>
246 <seg>/etc/gre.d, /usr/include/xulrunner-&xulrunner-version;,
247 /usr/lib/xulrunner-&xulrunner-version;,
248 /usr/lib/xulrunner-devel-&xulrunner-version;, and
249 /usr/share/idl/xulrunner-&xulrunner-version;</seg>
250 </seglistitem>
251 </segmentedlist>
252
253 <variablelist>
254 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
255 <?dbfo list-presentation="list"?>
256 <?dbhtml list-presentation="table"?>
257
258 <varlistentry id="xulrunner-prog">
259 <term><command>xulrunner</command></term>
260 <listitem>
261 <para>is a shell script, useful for identifying the version
262 installed.</para>
263 <indexterm zone="xulrunner xulrunner-prog">
264 <primary sortas="b-xulrunner">xulrunner</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 </variablelist>
270
271 </sect2>
272
273</sect1>
Note: See TracBrowser for help on using the repository browser.