%general-entities; ]> $LastChangedBy$ $Date$ Xulrunner-&xulrunner-version; Xulrunner Introduction to Xulrunner Xulrunner is a runtime environment for XUL applications, and forms the major part of the Mozilla codebase. In particular, it provides the gecko engine together with pkgconfig files so that applications such as Yelp can find and use it. However, be aware that Gnome applications are transitioning to Webkit instead of gecko. &lfs70_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &xulrunner-md5sum; Download size: &xulrunner-size; Estimated disk space required: &xulrunner-buildsize; Estimated build time: &xulrunner-time; Additional Downloads Required patch: Xulrunner Dependencies Required , , and Note: libjpeg and libpng (patched for apng support) should have been installed before gdk-pixbuf and should exist on your system. If for some strange reason you haven't installed them, you should remove the and options from the mozconfig file created below. Recommended or . Optional , , , libvpx, Hunspell, Libevent, , and (for gnome integration), , , , , , Valgrind (only for testing the jemalloc code) and User Notes: Installation of Xulrunner The configuration of Xulrunner is accomplished by creating a mozconfig file containing the desired configuration options. A default mozconfig is created below. To see the entire list of available configuration options (and an abbreviated description of each one), issue ./configure --help. You should review the entire file and comment or uncomment options as necessary. patch -p1 < ../xulrunner-&xulrunner-version;-libpng-1.5-1.patch && cat > mozconfig << "EOF" # If you have a multicore machine you can speed up the build by running # several jobs at once, but if you have a single core, delete this line: mk_add_options MOZ_MAKE_FLAGS="-j4" # If you have installed Yasm delete this option: ac_add_options --disable-webm # If you have installed DBus-Glib delete this option: ac_add_options --disable-dbus # If you have installed wireless-tools delete this option: ac_add_options --disable-necko-wifi # If you have installed libnotify delete this option: ac_add_options --disable-libnotify # Uncomment these if you have installed them: # ac_add_options --with-system-nspr # ac_add_options --with-system-nss # ac_add_options --enable-system-sqlite # ac_add_options --with-system-libvpx # ac_add_options --enable-startup-notification # ac_add_options --enable-system-hunspell # ac_add_options --with-system-libevent mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/xulrunner-build-dir ac_add_options --prefix=/usr ac_add_options --enable-application=xulrunner ac_add_options --with-pthreads ac_add_options --enable-system-ffi ac_add_options --with-system-jpeg ac_add_options --with-system-png ac_add_options --enable-system-cairo ac_add_options --with-system-zlib ac_add_options --enable-shared ac_add_options --disable-static ac_add_options --disable-debug ac_add_options --disable-crashreporter ac_add_options --disable-installer ac_add_options --disable-updater ac_add_options --disable-tests EOF Install Xulrunner by issuing the following commands: sed -i '/Version/aRequires: nspr >= &nspr-version;' xulrunner/installer/libxul-embedding.pc.in && make -f client.mk This package does not come with a test suite. Now, as the root user: make -C xulrunner-build-dir install && mkdir -p /usr/lib/mozilla && rm -rf /usr/lib/xulrunner-&xulrunner-version;/plugins && ln -sv ../mozilla/plugins /usr/lib/xulrunner-&xulrunner-version; && chown -Rv root:root /usr/{include,lib,share/idl}/xulrunner-* If you elected to use the included NSPR and NSS (ie, if you have not installed and ), while still the root user, complete the installation with the following commands: for DL in libnss3.so libnssutil3.so libsmime3.so \ libssl3.so libsoftokn3.so libplds4.so libplc4.so libnspr4.so do ln -sv xulrunner-&xulrunner-version;/${DL} /usr/lib done && unset DL Command Explanations sed ... Requires: nspr: If you try to build Yelp without this, the prtypes header from NSPR will not be found. It is arguable whose error this is (the code presumably works on earlier geckos), but this fix is unlikely to cause any damage in other packages. make -f client.mk ...: Mozilla products are packaged to allow the use of a configuration file which can be used to pass the configuration settings to the configure command. make uses the client.mk file to get initial configuration and setup parameters. for DL in ...: The NSPR and NSS libraries shipped with this package are installed into /usr/lib/xulrunner-&xulrunner-version; which means they will not be found at runtime. By using symbolic links from /usr/lib the libraries will be found and the links can be easily changed to point to a newer version during an upgrade. ln -sv ../mozilla/plugins ...: Some packages will install browser plugins into /usr/lib/mozilla/plugins. Creating this symlink Xulrunner keeps additional plugins in a common directory. When you upgrade Xulrunner, remember to update the symlinks. Contents Installed Programs Installed Libraries Installed Directories xulrunner, and optionally nspr-config Numerous libraries, browser components, plugins, extensions, and helper modules installed in /usr/lib/xulrunner-&xulrunner-version; /etc/gre.d, /usr/include/xulrunner-&xulrunner-version;, /usr/lib/xulrunner-&xulrunner-version;, /usr/lib/xulrunner-devel-&xulrunner-version;, and /usr/share/idl/xulrunner-&xulrunner-version; Short Descriptions xulrunner is a shell script, useful for identifying the version installed. xulrunner