source: x/lib/xulrunner.xml@ c84d97ad

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

a couple of little firefox/xulrunner tweaks

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

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