%general-entities; ]> $LastChangedBy$ $Date$ Firefox-&firefox-version; Firefox Introduction to Firefox Firefox is a stand-alone browser based on the Mozilla codebase. &lfs73_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &firefox-md5sum; Download size: &firefox-size; Estimated disk space required: &firefox-buildsize; Estimated build time: &firefox-time; Firefox Dependencies Required , , , and Recommended , , , , and If you don't install recommended dependencies, then internal copies of those packages will be used. They might be tested to work, but they can be out of date or contain security holes. Optional , , , and (for integration with the old version of GNOME), Hunspell, , , , and User Notes: Installation of Firefox There are two major methods for building Firefox. In the standard case, the entire suite of libraries is built and installed. In the other, most of the system is built using the procedures found in . This is advantageous if you are planning to build other related packages such as . With either build method, you need to run the main build procedure below with the appropriate options in the mozconfig file. Then use the appropriate install instructions depending on the chosen build method. The configuration of Firefox 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 may also wish to review the entire file and uncomment any other desired options. The commented line for --with-libxul-sdk has an escaped dollar sign - if you have chosed to paste the entries into a mozconfig file in your editor, you do not need the escape, it is only necessary when invoking a subshell in a HERE document. Create the file by issuing the following command: cat > mozconfig << "EOF" # If you have a multicore machine you can speed up the build by running # several jobs at once by uncommenting the following line and setting the # value to number of CPU cores: #mk_add_options MOZ_MAKE_FLAGS="-j4" # If you have installed DBus-Glib comment out this line: ac_add_options --disable-dbus # If you have installed wireless-tools comment out this line: ac_add_options --disable-necko-wifi # If you have installed libnotify comment out this line: ac_add_options --disable-libnotify # Uncomment these lines if you have installed optional dependencies: #ac_add_options --enable-system-hunspell #ac_add_options --enable-startup-notification # If you have not installed Yasm then uncomment this line: #ac_add_options --disable-webm # If you have installed xulrunner uncomment following two lines: #ac_add_options --with-system-libxul #ac_add_options --with-libxul-sdk=\$(pkg-config --variable=sdkdir libxul) # Comment out following options if you have not installed # recommended dependencies: ac_add_options --enable-system-sqlite ac_add_options --with-system-libevent ac_add_options --with-system-libvpx ac_add_options --with-system-nspr ac_add_options --with-system-nss # It is recommended not to touch anything below this line ac_add_options --prefix=/usr ac_add_options --enable-application=browser ac_add_options --disable-crashreporter ac_add_options --disable-installer ac_add_options --disable-updater ac_add_options --disable-debug ac_add_options --disable-tests ac_add_options --enable-optimize ac_add_options --enable-strip ac_add_options --enable-install-strip ac_add_options --enable-gio ac_add_options --enable-official-branding ac_add_options --enable-safe-browsing ac_add_options --enable-url-classifier ac_add_options --enable-system-ffi ac_add_options --enable-system-pixman ac_add_options --with-pthreads ac_add_options --with-system-bz2 ac_add_options --with-system-jpeg ac_add_options --with-system-png ac_add_options --with-system-zlib mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/firefox-build-dir EOF Compile Firefox by issuing the following commands: sed -i 's@ ""@@' browser/base/Makefile.in && sed -i "/gre_path/s@DIST'\]@& + '/bin'@" toolkit/mozapps/installer/packager.py && make -f client.mk This package does not come with a test suite. If you have not linked Firefox against an installed Xulrunner: make -C firefox-build-dir/browser/installer Now, as the root user, if you have not linked Firefox against an installed Xulrunner, install the package: rm -rf /usr/lib/firefox-&firefox-version; && mkdir /usr/lib/firefox-&firefox-version; && tar -xvf firefox-build-dir/dist/firefox-&firefox-version;.en-US.linux-$(uname -m).tar.bz2 \ -C /usr/lib/firefox-&firefox-version; --strip-components=1 && chown -R -v root:root /usr/lib/firefox-&firefox-version; && chmod -v 755 /usr/lib/firefox-&firefox-version;/libxpcom.so && ln -sfv ../lib/firefox-&firefox-version;/firefox /usr/bin && mkdir -pv /usr/lib/mozilla/plugins && ln -sfv ../mozilla/plugins /usr/lib/firefox-&firefox-version; If you have linked against an already installed Xulrunner, as the root user: make -C firefox-build-dir install && ln -sfv ../lib/firefox-&firefox-version;/firefox /usr/bin && ln -sfv ../xulrunner-&firefox-version; /usr/lib/firefox-&firefox-version;/xulrunner && mkdir -pv /usr/lib/mozilla/plugins && ln -sfv ../mozilla/plugins /usr/lib/firefox-&firefox-version; NPAPI Headers The above instructions just install the parts you need to run Firefox. If you want to compile , the open source version of Flash, copy some headers that Gnash needs into /usr/include, as the root user: rm -rf /usr/include/npapi && mkdir -v /usr/include/npapi && cp -v dom/plugins/base/*.h /usr/include/npapi You don't need to install the headers if you have built Firefox against Xulrunner. Command Explanations sed -i 's@ ""@@' browser/base/Makefile.in: This sed removes an unprintable control character from the title bar. sed -i "/gre_path/s@DIST'\]@& + '/bin'@" ...: This sed fixes build with Xulrunner. 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. make -C firefox-build-dir/browser/installer: this creates a Firefox tarball similar to the ones you can download from Mozilla. tar -xfv firefox-build-dir/dist ...: This untars Firefox in /usr/lib. The option removes the leading 'firefox' directory from the filenames, allowing us to untar it into a versioned directory. make -C firefox-build-dir install: This runs make install in firefox-build-dir. ln -sfv ... /usr/bin/firefox: This puts a symbolic link to the firefox executable in your PATH variable. mkdir -p /usr/lib/mozilla/plugins: This checks that /usr/lib/mozilla/plugins exists. ln -sv ... /usr/lib/firefox-&firefox-version;: This command creates a symbolic link to /usr/lib/mozilla/plugins. It's not really needed, as Firefox checks /usr/lib/mozilla/plugins by default, but the symbolic link is made to keep all the plugins installed in one folder. Configuring Firefox If you deleted the option from your mozconfig, your Firefox can play most YouTube videos without the need for the flash plugin. To enable this, go to and click on 'Join the HTML5 Trial' (needs cookies enabled). If you use a desktop environment like Gnome or KDE you may like to create a firefox.desktop file so that Firefox appears in the panel's menus. If you didn't enable startup-notification in your mozconfig change the StartupNotify line to false. As the root user: mkdir -pv /usr/share/applications && mkdir -pv /usr/share/pixmaps && cat > /usr/share/applications/firefox.desktop << "EOF" && [Desktop Entry] Encoding=UTF-8 Name=Firefox Web Browser Comment=Browse the World Wide Web GenericName=Web Browser Exec=firefox %u Terminal=false Type=Application Icon=firefox Categories=GNOME;GTK;Network;WebBrowser; MimeType=text/html;text/xml;application/xhtml+xml;application/vnd.mozilla.xul+xml;text/mml;x-scheme-handler/http;x-scheme-handler/https; StartupNotify=true EOF ln -sfv /usr/lib/firefox-&firefox-version;/browser/icons/mozicon128.png \ /usr/share/pixmaps/firefox.png Contents Installed Programs Installed Libraries Installed Directories firefox Numerous libraries, browser components, plugins, extensions, and helper modules installed in /usr/lib/firefox-&firefox-version; /usr/include/npapi and /usr/lib/firefox-&firefox-version; Short Descriptions firefox is a GTK+ 2 internet browser that uses the Mozilla Gecko rendering engine. firefox