source: x/lib/xulrunner.xml@ 1c6fdeb

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 12.2 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 gimp3 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/for-12.3 xry111/intltool xry111/llvm18 xry111/soup3 xry111/spidermonkey128 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 1c6fdeb was 1c6fdeb, checked in by Andrew Benton <andy@…>, 13 years ago

Changed the links to yasm

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

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