[f939f05] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[ff769b8c] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
|
---|
[f939f05] | 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
[3f810bf2] | 7 | <!ENTITY firefox-download-http "http://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;-source.tar.bz2">
|
---|
| 8 | <!ENTITY firefox-download-ftp "ftp://ftp.mozilla.org/pub/mozilla.org/firefox/releases/&firefox-version;/source/firefox-&firefox-version;-source.tar.bz2">
|
---|
[b94212a] | 9 | <!ENTITY firefox-md5sum "f1a9a8da0547564a0f8a249f9d56bdf4">
|
---|
[1a07ee0] | 10 | <!ENTITY firefox-size "32 MB">
|
---|
[d1981e0] | 11 | <!ENTITY firefox-buildsize "564 MB">
|
---|
[b94212a] | 12 | <!ENTITY firefox-time "9.8 SBU">
|
---|
[f939f05] | 13 | ]>
|
---|
| 14 |
|
---|
[ffe47ca2] | 15 | <sect1 id="firefox" xreflabel="Firefox-&firefox-version;">
|
---|
[a0f03b0] | 16 | <sect1info>
|
---|
[5cd0959d] | 17 | <othername>$LastChangedBy$</othername>
|
---|
| 18 | <date>$Date$</date>
|
---|
[a0f03b0] | 19 | </sect1info>
|
---|
[6a1f1202] | 20 | <?dbhtml filename="firefox.html" ?>
|
---|
[ffe47ca2] | 21 | <title>Firefox-&firefox-version;</title>
|
---|
[e3c939cc] | 22 | <indexterm zone="firefox">
|
---|
| 23 | <primary sortas="a-Firefox">Firefox</primary></indexterm>
|
---|
[4d37129] | 24 |
|
---|
[f939f05] | 25 | <sect2>
|
---|
[ffe47ca2] | 26 | <title>Introduction to <application>Firefox</application></title>
|
---|
[f939f05] | 27 |
|
---|
[ffe47ca2] | 28 | <para><application>Firefox</application> is a stand-alone browser
|
---|
[f939f05] | 29 | based on the <application>Mozilla</application> codebase.</para>
|
---|
| 30 |
|
---|
| 31 | <sect3><title>Package information</title>
|
---|
| 32 | <itemizedlist spacing='compact'>
|
---|
| 33 | <listitem><para>Download (HTTP): <ulink
|
---|
| 34 | url="&firefox-download-http;"/></para></listitem>
|
---|
| 35 | <listitem><para>Download (FTP): <ulink
|
---|
| 36 | url="&firefox-download-ftp;"/></para></listitem>
|
---|
[d1981e0] | 37 | <listitem><para>Download MD5 sum: &firefox-md5sum;</para></listitem>
|
---|
[f939f05] | 38 | <listitem><para>Download size: &firefox-size;</para></listitem>
|
---|
[3e602d7a] | 39 | <listitem><para>Estimated disk space required:
|
---|
[f939f05] | 40 | &firefox-buildsize;</para></listitem>
|
---|
| 41 | <listitem><para>Estimated build time:
|
---|
| 42 | &firefox-time;</para></listitem></itemizedlist>
|
---|
| 43 | </sect3>
|
---|
| 44 |
|
---|
[ffe47ca2] | 45 | <sect3><title><application>Firefox</application> dependencies</title>
|
---|
[f939f05] | 46 | <sect4><title>Required</title>
|
---|
[a8eba10] | 47 | <para><xref linkend="gtk2"/>,
|
---|
[f3d3f503] | 48 | <xref linkend="libidl"/> and
|
---|
[d1981e0] | 49 | <xref linkend="zip"/></para>
|
---|
| 50 | </sect4>
|
---|
| 51 |
|
---|
[82f09cd1] | 52 | <sect4><title>Optional</title>
|
---|
[d1981e0] | 53 | <para><xref linkend="libjpeg"/>,
|
---|
| 54 | <xref linkend="unzip"/>,
|
---|
[b94212a] | 55 | <xref linkend="gnome-vfs"/> and
|
---|
| 56 | <xref linkend="libgnome"/> (to build the gnomevfs extension),
|
---|
[d1981e0] | 57 | <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>
|
---|
[b94212a] | 58 | (for the GSSAPI libraries to build the negotiateauth extension),
|
---|
[cef3a2f] | 59 | <xref linkend="doxygen"/>,
|
---|
[d1981e0] | 60 | <ulink url="http://xprint.mozdev.org/">Xprint</ulink>,
|
---|
[faa80ab] | 61 | <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink> and
|
---|
[d1981e0] | 62 | <ulink url="http://cairographics.org/">Cairo</ulink></para>
|
---|
| 63 | </sect4>
|
---|
[f939f05] | 64 | </sect3>
|
---|
| 65 |
|
---|
| 66 | </sect2>
|
---|
| 67 |
|
---|
| 68 | <sect2>
|
---|
[ffe47ca2] | 69 | <title>Installation of <application>Firefox</application></title>
|
---|
[f939f05] | 70 |
|
---|
[488b6a53] | 71 | <para>The configuration of <application>Firefox</application> is very similar
|
---|
| 72 | to <xref linkend="mozilla"/> and hence the options are not discussed. Refer to
|
---|
| 73 | the <xref linkend="mozilla"/> instructions for explanations and additional
|
---|
| 74 | configuration information.</para>
|
---|
[f939f05] | 75 |
|
---|
[ffe47ca2] | 76 | <para>Compile and install <application>Firefox</application> by
|
---|
[f939f05] | 77 | running the following commands:</para>
|
---|
| 78 |
|
---|
| 79 | <screen><userinput><command>export MOZILLA_OFFICIAL="1" &&
|
---|
| 80 | export BUILD_OFFICIAL="1" &&
|
---|
| 81 | export MOZ_PHOENIX="1" &&
|
---|
[3e602d7a] | 82 | ./configure --prefix=/usr \
|
---|
[0683349d] | 83 | --with-default-mozilla-five-home=/usr/lib/firefox-1.0 \
|
---|
[d1981e0] | 84 | --with-user-appdir=.firefox \
|
---|
[ffe47ca2] | 85 | --with-system-zlib \
|
---|
| 86 | --with-system-png \
|
---|
[d1981e0] | 87 | --enable-application=browser \
|
---|
[f939f05] | 88 | --enable-default-toolkit=gtk2 \
|
---|
[b94212a] | 89 | --enable-extensions=cookie,xml-rpc,xmlextras,pref,\
|
---|
| 90 | transformiix,universalchardet,webservices,inspector,\
|
---|
| 91 | gnomevfs,negotiateauth \
|
---|
[ffe47ca2] | 92 | --enable-crypto \
|
---|
[d1981e0] | 93 | --enable-xft \
|
---|
[ffe47ca2] | 94 | --enable-xinerama \
|
---|
| 95 | --enable-optimize \
|
---|
| 96 | --enable-reorder \
|
---|
| 97 | --enable-strip \
|
---|
| 98 | --enable-cpp-rtti \
|
---|
[d1981e0] | 99 | --enable-single-profile \
|
---|
| 100 | --disable-freetype2 \
|
---|
| 101 | --disable-accessibility \
|
---|
| 102 | --disable-debug \
|
---|
| 103 | --disable-tests \
|
---|
| 104 | --disable-logging \
|
---|
| 105 | --disable-pedantic \
|
---|
| 106 | --disable-installer \
|
---|
| 107 | --disable-mailnews \
|
---|
| 108 | --disable-ldap \
|
---|
| 109 | --disable-composer \
|
---|
[ffe47ca2] | 110 | --disable-profilesharing &&
|
---|
[e3c939cc] | 111 | make</command></userinput></screen>
|
---|
| 112 |
|
---|
[b4b7337e] | 113 | <para>You should add the <option>--with-system-jpeg</option> switch to the
|
---|
| 114 | <command>configure</command> script if you have
|
---|
| 115 | <application>libjpeg</application> installed.</para>
|
---|
| 116 |
|
---|
[4a8e9f7] | 117 | <para>This package does not come with a test suite.</para>
|
---|
| 118 |
|
---|
[e3c939cc] | 119 | <para>Now, as the root user:</para>
|
---|
| 120 |
|
---|
| 121 | <screen><userinput role='root'><command>make install &&
|
---|
[59daef29] | 122 | install -d /usr/include/firefox-&firefox-version;/nss &&
|
---|
[488b6a53] | 123 | cp -Lf dist/private/nss/*.h dist/public/nss/*.h \
|
---|
[d1981e0] | 124 | /usr/include/firefox-&firefox-version;/nss</command></userinput></screen>
|
---|
[ffe47ca2] | 125 |
|
---|
[e3c939cc] | 126 | <para>To enable multi-user operation, execute the following as the root
|
---|
| 127 | user:</para>
|
---|
[f939f05] | 128 |
|
---|
[b94212a] | 129 | <screen><userinput role='root'><command>cd /usr/lib/firefox-&firefox-version; &&
|
---|
[f939f05] | 130 | export LD_LIBRARY_PATH="$PWD" &&
|
---|
| 131 | export MOZILLA_FIVE_HOME="$PWD" &&
|
---|
| 132 | ./regxpcom &&
|
---|
| 133 | ./regchrome &&
|
---|
[488b6a53] | 134 | touch `find . -name *.rdf`</command></userinput></screen>
|
---|
[f939f05] | 135 |
|
---|
[d1981e0] | 136 | <note><para>You should run <command>/usr/bin/firefox</command> once as the
|
---|
| 137 | root user (or any user with write privileges) to create some necessary
|
---|
| 138 | additional files in the <filename class='directory'>/usr</filename>
|
---|
[488b6a53] | 139 | hierarchy.</para></note>
|
---|
[82539b8b] | 140 |
|
---|
[b94212a] | 141 | <para>Lastly, unset the build variables from the unprivileged user's
|
---|
| 142 | environment:</para>
|
---|
| 143 |
|
---|
| 144 | <screen><userinput><command>unset MOZILLA_OFFICIAL &&
|
---|
| 145 | unset BUILD_OFFICIAL &&
|
---|
| 146 | unset MOZ_PHOENIX</command></userinput></screen>
|
---|
[82539b8b] | 147 | </sect2>
|
---|
| 148 |
|
---|
[c8401dd1] | 149 | <sect2>
|
---|
| 150 | <title>Configuring <application>Firefox</application></title>
|
---|
| 151 |
|
---|
| 152 | <para>No specific configuration is required as long as the
|
---|
| 153 | <command>firefox</command> script is in the user's path. If
|
---|
| 154 | <application>Firefox</application> is installed in a non-standard location,
|
---|
| 155 | then make a symlink to the <command>firefox</command> script from
|
---|
| 156 | <filename class="directory">/usr/bin</filename>.</para>
|
---|
| 157 |
|
---|
| 158 | <para>Many applications look for <command>netscape</command> when they need to
|
---|
| 159 | open a browser. You may make the following symlink for convenience (as the
|
---|
| 160 | root user).</para>
|
---|
| 161 |
|
---|
| 162 | <screen><userinput role='root'><command>ln -v -sf firefox /usr/bin/netscape</command></userinput></screen>
|
---|
| 163 |
|
---|
| 164 | <para>For installing various <application>Firefox</application> plugins, refer
|
---|
| 165 | to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's PluginDoc
|
---|
[5f0bab7] | 166 | Project</ulink>. If you have <xref linkend="jdk"/> already installed, create
|
---|
[c8401dd1] | 167 | the following link as the root user to utilize the
|
---|
| 168 | <application>JAVA</application> plugin: </para>
|
---|
| 169 |
|
---|
| 170 | <screen><userinput role='root'><command>ln -v -s $JAVA_HOME/jre/plugin/i386/ns7/libjavaplugin_oji.so \
|
---|
| 171 | /usr/lib/firefox-&firefox-version;/plugins</command></userinput></screen>
|
---|
| 172 |
|
---|
| 173 | </sect2>
|
---|
| 174 |
|
---|
[82539b8b] | 175 | <sect2>
|
---|
| 176 | <title>Contents</title>
|
---|
| 177 |
|
---|
[e3c939cc] | 178 | <segmentedlist>
|
---|
[4a8e9f7] | 179 | <segtitle>Installed Programs</segtitle>
|
---|
[e3c939cc] | 180 | <segtitle>Installed Libraries</segtitle>
|
---|
| 181 | <segtitle>Installed Directories</segtitle>
|
---|
| 182 |
|
---|
| 183 | <seglistitem>
|
---|
[4a8e9f7] | 184 | <seg>firefox and firefox-config</seg>
|
---|
[e3c939cc] | 185 | <seg>Numerous libraries, browser components, plugins, extensions and helper
|
---|
| 186 | modules installed in
|
---|
| 187 | <filename class='directory'>/usr/lib/firefox-&firefox-version;</filename></seg>
|
---|
[b4b7337e] | 188 | <seg>/usr/bin/defaults, /usr/include/firefox-&firefox-version;,
|
---|
[e3c939cc] | 189 | /usr/lib/firefox-&firefox-version; and
|
---|
| 190 | /usr/share/idl/firefox-&firefox-version;</seg>
|
---|
| 191 | </seglistitem>
|
---|
| 192 | </segmentedlist>
|
---|
| 193 |
|
---|
| 194 | <variablelist>
|
---|
| 195 | <bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
---|
| 196 | <?dbfo list-presentation="list"?>
|
---|
| 197 |
|
---|
| 198 | <varlistentry id="firefox-prog">
|
---|
| 199 | <term><command>firefox</command></term>
|
---|
| 200 | <listitem><para>is the next-generation browser from Mozilla.</para>
|
---|
| 201 | <indexterm zone="firefox firefox-prog">
|
---|
| 202 | <primary sortas="b-firefox">firefox</primary>
|
---|
| 203 | </indexterm></listitem>
|
---|
| 204 | </varlistentry>
|
---|
[82539b8b] | 205 |
|
---|
[4a8e9f7] | 206 | <varlistentry id="firefox-config">
|
---|
| 207 | <term><command>firefox-config</command></term>
|
---|
| 208 | <listitem><para>determines the compile and linker flags that should be
|
---|
| 209 | used to compile and link programs that use
|
---|
| 210 | <application>Firefox</application> libraries and browser
|
---|
| 211 | components.</para>
|
---|
| 212 | <indexterm zone="firefox firefox-config">
|
---|
| 213 | <primary sortas="b-firefox-config">firefox-config</primary>
|
---|
| 214 | </indexterm></listitem>
|
---|
| 215 | </varlistentry>
|
---|
| 216 | </variablelist>
|
---|
| 217 |
|
---|
[f939f05] | 218 | </sect2>
|
---|
[4d37129] | 219 |
|
---|
| 220 | </sect1>
|
---|