Changeset 88dd2f52


Ignore:
Timestamp:
05/21/2005 08:55:58 AM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 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, 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/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
ab49f6cb
Parents:
12e12fb2
Message:

Tagged mozilla.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • xsoft/graphweb/mozilla.xml

    r12e12fb2 r88dd2f52  
    1919
    2020<sect1 id="mozilla" xreflabel="Mozilla-&mozilla-version;">
    21 <sect1info>
    22 <othername>$LastChangedBy$</othername>
    23 <date>$Date$</date>
    24 </sect1info>
    25 <?dbhtml filename="mozilla.html" ?>
    26 <title>Mozilla-&mozilla-version;</title>
    27 <indexterm zone="mozilla">
    28 <primary sortas="a-Mozilla">Mozilla</primary>
    29 </indexterm>
    30 
    31 <sect2>
    32 <title>Introduction to <application>Mozilla</application></title>
    33 
    34 <para><application>Mozilla</application> is a browser suite, the Open Source
    35 sibling of <application>Netscape</application>. It includes the browser,
    36 composer, mail and news clients, a calendar client and an
    37 <acronym>IRC</acronym> client.</para>
    38 
    39 <para>The <application>Mozilla</application> project also hosts two subprojects
    40 that aim to satisfy the needs of users who don't need the complete browser
    41 suite or prefer to have separate applications for browsing and e-mail. These
    42 subprojects are
    43 <ulink url="http://www.mozilla.org/products/firefox/">Mozilla Firefox</ulink>,
    44 (a stand-alone browser based on the
    45 <application>Mozilla</application> source code) and <ulink
    46 url="http://www.mozilla.org/products/thunderbird/">Mozilla Thunderbird</ulink>,
    47 (a stand-alone mail client based on the <application>Mozilla</application>
    48 source code). The build instructions for these two applications are discussed
    49 in separate sections:</para>
    50 
    51 <itemizedlist>
    52 <listitem><para><xref linkend="firefox"/></para></listitem>
    53 <listitem><para><xref linkend="thunderbird"/></para></listitem>
    54 </itemizedlist>
    55 
    56 <sect3><title>Package information</title>
    57 <itemizedlist spacing='compact'>
    58 <listitem><para>Download (HTTP): <ulink
    59 url="&mozilla-download-http;"/></para></listitem>
    60 <listitem><para>Download (FTP): <ulink
    61 url="&mozilla-download-ftp;"/></para></listitem>
    62 <listitem><para>Download MD5 sum:
    63 &mozilla-md5sum;</para></listitem>
    64 <listitem><para>Download size: &mozilla-size;</para></listitem>
    65 <listitem><para>Estimated disk space required:
    66 &mozilla-buildsize;</para></listitem>
    67 <listitem><para>Estimated build time:
    68 &mozilla-time;</para></listitem></itemizedlist>
    69 </sect3>
    70 
    71 <sect3><title>Additional downloads</title>
    72 
    73 <para>To enable the <application>Enigmail</application> extension to the
    74 <application>Mozilla</application> mail client, you'll need to download the
    75 two tarballs below. The <application>Enigmail</application> extension allows
    76 users to access the authentication and encryption features provided by the
    77 <application>GnuPG</application> package.</para>
    78 
    79 <itemizedlist spacing='compact'>
    80 <listitem><para><ulink
    81 url="http://downloads.mozdev.org/enigmail/src/enigmail-&mozilla-enigmail-version;.tar.gz"/>
    82 </para></listitem>
    83 <listitem><para>Download MD5 sum (Enigmail):
    84 &mozilla-enigmail-md5sum;</para></listitem>
    85 <listitem><para><ulink
    86 url="http://downloads.mozdev.org/enigmail/src/ipc-&mozilla-ipc-version;.tar.gz"/>
    87 </para></listitem>
    88 <listitem><para>Download MD5 sum (IPC):
    89 &mozilla-ipc-md5sum;</para></listitem>
    90 </itemizedlist>
    91 </sect3>
    92 
    93 <sect3><title><application>Mozilla</application> dependencies</title>
    94 <sect4><title>Required</title>
    95 <para><xref linkend="zip"/>,
    96 <xref linkend="gtk2"/>,
    97 <xref linkend="libidl"/></para>
    98 </sect4>
    99 
    100 <sect4><title>Recommended</title>
    101 <para><xref linkend="gnupg"/> (for the <application>Enigmail</application>
    102 extension)</para>
    103 </sect4>
    104 
    105 <sect4><title>Optional</title>
    106 <para><xref linkend="libjpeg"/>,
    107 <xref linkend="unzip"/>,
    108 <xref linkend="gnome-vfs"/> (to build the gnomevfs extension),
    109 <xref linkend="libart_lgpl"/>,
    110 <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>
    111 (for the GSSAPI libraries to build the negotiateauth extension),
    112 <xref linkend="doxygen"/>,
    113 <ulink url="http://xprint.mozdev.org/">Xprint</ulink>,
    114 <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink> and
    115 <ulink url="http://cairographics.org/">Cairo</ulink></para>
    116 </sect4>
    117 </sect3>
    118 
    119 </sect2>
    120 
    121 <sect2>
    122 <title>Installation of <application>Mozilla</application></title>
    123 
    124 <para>Compile <application>Mozilla</application> by running the following
    125 commands:</para>
    126 
    127 <screen><userinput><command>export MOZILLA_OFFICIAL="1" &amp;&amp;
     21  <?dbhtml filename="mozilla.html" ?>
     22
     23  <sect1info>
     24    <othername>$LastChangedBy$</othername>
     25    <date>$Date$</date>
     26  </sect1info>
     27
     28  <title>Mozilla-&mozilla-version;</title>
     29
     30  <indexterm zone="mozilla">
     31    <primary sortas="a-Mozilla">Mozilla</primary>
     32  </indexterm>
     33
     34  <sect2 role="package">
     35    <title>Introduction to Mozilla</title>
     36
     37    <para><application>Mozilla</application> is a browser suite, the Open
     38    Source sibling of <application>Netscape</application>. It includes the
     39    browser, composer, mail and news clients, a calendar client and an
     40    IRC client.</para>
     41
     42    <para>The <application>Mozilla</application> project also hosts two
     43    subprojects that aim to satisfy the needs of users who don't need the
     44    complete browser suite or prefer to have separate applications for
     45    browsing and e-mail. These subprojects are <ulink
     46    url="http://www.mozilla.org/products/firefox/">Mozilla Firefox</ulink>,
     47    (a stand-alone browser based on the <application>Mozilla</application>
     48    source code) and <ulink
     49    url="http://www.mozilla.org/products/thunderbird/">Mozilla
     50    Thunderbird</ulink>, (a stand-alone mail client based on the
     51    <application>Mozilla</application> source code). The build instructions
     52    for these two applications are discussed in separate sections:</para>
     53
     54    <itemizedlist>
     55      <listitem>
     56        <para><xref linkend="firefox"/></para>
     57      </listitem>
     58      <listitem>
     59        <para><xref linkend="thunderbird"/></para>
     60      </listitem>
     61    </itemizedlist>
     62
     63    <bridgehead renderas="sect3">Package Information</bridgehead>
     64    <itemizedlist spacing="compact">
     65      <listitem>
     66        <para>Download (HTTP): <ulink url="&mozilla-download-http;"/></para>
     67      </listitem>
     68      <listitem>
     69        <para>Download (FTP): <ulink url="&mozilla-download-ftp;"/></para>
     70      </listitem>
     71      <listitem>
     72        <para>Download MD5 sum: &mozilla-md5sum;</para>
     73      </listitem>
     74      <listitem>
     75        <para>Download size: &mozilla-size;</para>
     76      </listitem>
     77      <listitem>
     78        <para>Estimated disk space required: &mozilla-buildsize;</para>
     79      </listitem>
     80      <listitem>
     81        <para>Estimated build time: &mozilla-time;</para>
     82      </listitem>
     83    </itemizedlist>
     84
     85    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     86
     87    <para>To enable the <application>Enigmail</application> extension to
     88    the <application>Mozilla</application> mail client, you'll need to
     89    download the two tarballs below. The <application>Enigmail</application>
     90    extension allows users to access the authentication and encryption
     91    features provided by the <application>GnuPG</application> package.</para>
     92
     93    <itemizedlist spacing='compact'>
     94      <listitem>
     95        <para><ulink
     96        url="http://downloads.mozdev.org/enigmail/src/enigmail-&mozilla-enigmail-version;.tar.gz"/>
     97        </para>
     98      </listitem>
     99      <listitem>
     100        <para>Download MD5 sum (Enigmail): &mozilla-enigmail-md5sum;</para>
     101      </listitem>
     102      <listitem>
     103        <para><ulink
     104        url="http://downloads.mozdev.org/enigmail/src/ipc-&mozilla-ipc-version;.tar.gz"/>
     105        </para>
     106      </listitem>
     107      <listitem>
     108        <para>Download MD5 sum (IPC): &mozilla-ipc-md5sum;</para>
     109      </listitem>
     110    </itemizedlist>
     111
     112    <bridgehead renderas="sect3">Mozilla Dependencies</bridgehead>
     113
     114    <bridgehead renderas="sect4">Required</bridgehead>
     115    <para><xref linkend="zip"/>,
     116    <xref linkend="gtk2"/>,
     117    <xref linkend="libidl"/></para>
     118
     119    <bridgehead renderas="sect4">Recommended</bridgehead>
     120    <para><xref linkend="gnupg"/> (for the <application>Enigmail</application>
     121    extension)</para>
     122
     123    <bridgehead renderas="sect4">Optional</bridgehead>
     124    <para><xref linkend="libjpeg"/>,
     125    <xref linkend="unzip"/>,
     126    <xref linkend="gnome-vfs"/> (to build the gnomevfs extension),
     127    <xref linkend="libart_lgpl"/>,
     128    <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>
     129    (for the GSSAPI libraries to build the negotiateauth extension),
     130    <xref linkend="doxygen"/>,
     131    <ulink url="http://xprint.mozdev.org/">Xprint</ulink>,
     132    <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink> and
     133    <ulink url="http://cairographics.org/">Cairo</ulink></para>
     134
     135  </sect2>
     136
     137  <sect2 role="installation">
     138    <title>Installation of Mozilla</title>
     139
     140    <para>Compile <application>Mozilla</application> by running the
     141    following commands:</para>
     142
     143<screen><userinput>export MOZILLA_OFFICIAL="1" &amp;&amp;
    128144export BUILD_OFFICIAL="1" &amp;&amp;
    129145export MOZ_CO_PROJECT="suite" &amp;&amp;
    … …  
    150166            --disable-pedantic \
    151167            --disable-installer &amp;&amp;
    152 make</command></userinput></screen>
    153 
    154 <para>You should add the <option>--with-system-jpeg</option> switch to the
    155 <command>configure</command> script if you have
    156 <application>libjpeg</application> installed.</para>
    157 
    158 <para>If you're building the <application>Mozilla</application> mail and news
    159 clients and plan to install the <application>Enigmail</application>
    160 extension, execute the following steps:</para>
    161 
    162 <screen><userinput><command>tar -zxf ../enigmail-&mozilla-enigmail-version;.tar.gz -C extensions &amp;&amp;
     168make</userinput></screen>
     169
     170    <para>You should add the <option>--with-system-jpeg</option> switch
     171    to the <command>configure</command> script if you have
     172    <application>libjpeg</application> installed.</para>
     173
     174    <para>If you're building the <application>Mozilla</application> mail
     175    and news clients and plan to install the <application>Enigmail</application>
     176    extension, execute the following steps:</para>
     177
     178<screen><userinput>tar -zxf ../enigmail-&mozilla-enigmail-version;.tar.gz -C extensions &amp;&amp;
    163179tar -zxf ../ipc-&mozilla-ipc-version;.tar.gz -C extensions &amp;&amp;
    164180build/autoconf/make-makefile extensions/ipc extensions/enigmail &amp;&amp;
    165181make -C extensions/ipc &amp;&amp;
    166 make -C extensions/enigmail</command></userinput></screen>
    167 
    168 <para>Install <application>Mozilla</application> (as the root user) as
    169 follows:</para>
    170 
    171 <screen><userinput role='root'><command>make install &amp;&amp;
     182make -C extensions/enigmail</userinput></screen>
     183
     184    <para>Install <application>Mozilla</application> (as the
     185    <systemitem class="username">root user</systemitem>) as follows:</para>
     186
     187<screen role="root"><userinput>make install &amp;&amp;
    172188install -v -d -m755 /usr/include/mozilla-&mozilla-version;/nss &amp;&amp;
    173189cp -v -Lf dist/private/nss/*.h dist/public/nss/*.h \
    … …  
    178194    rm -v -rf /usr/lib/mozilla
    179195fi &amp;&amp;
    180 ln -v -nsf mozilla-&mozilla-version; /usr/lib/mozilla</command></userinput></screen>
    181 
    182 <para>If you're installing the <application>Enigmail</application> extension,
    183 issue the following commands as the root user:</para>
    184 
    185 <screen><userinput role='root'><command>make -C extensions/ipc install &amp;&amp;
    186 make -C extensions/enigmail install</command></userinput></screen>
    187 
    188 <para>Some libraries, including the Netscape Portable Runtime
    189 (<acronym>NSPR</acronym>) and Network Security Services
    190 (<acronym>NSS</acronym>) libraries, installed by
    191 <application>Mozilla</application> are also needed by other packages. These
    192 libraries should be in <filename>/usr/lib</filename> so that other packages
    193 can link against them. As the root user, move them as follows:</para>
    194 
    195 <screen><userinput role='root'><command>for i in \
     196ln -v -nsf mozilla-&mozilla-version; /usr/lib/mozilla</userinput></screen>
     197
     198    <para>If you're installing the <application>Enigmail</application>
     199    extension, issue the following commands as the
     200    <systemitem class="username">root</systemitem> user:</para>
     201
     202<screen role="root"><userinput>make -C extensions/ipc install &amp;&amp;
     203make -C extensions/enigmail install</userinput></screen>
     204
     205    <para>Some libraries, including the Netscape Portable Runtime (NSPR) and
     206    Network Security Services (NSS) libraries, installed by
     207    <application>Mozilla</application> are also needed by other packages.
     208    These libraries should be in <filename class="directory">/usr/lib</filename>
     209    so that other packages can link against them. As the <systemitem
     210    class="username">root</systemitem> user, move them as follows:</para>
     211
     212<screen role="root"><userinput>for i in \
    196213    lib{nspr4,plc4,plds4,nss3,smime3,softokn3,ssl3}.so libsoftokn3.chk
    197214do
    198215   mv -v /usr/lib/mozilla-&mozilla-version;/$i /usr/lib/
    199216   ln -v -sf ../$i /usr/lib/mozilla-&mozilla-version;/
    200 done</command></userinput></screen>
    201 
    202 <para>Create the required component registries to enable multi-user installs.
    203 These steps should be preformed by the root user each time a
    204 <application>Mozilla</application> add-on is installed. This will allow normal
    205 users to run <command>mozilla</command>. Enable multi-user operation by
    206 executing the following:</para>
    207 
    208 <screen><userinput role='root'><command>cd /usr/lib/mozilla-&mozilla-version; &amp;&amp;
     217done</userinput></screen>
     218
     219    <para>Create the required component registries to enable multi-user
     220    installs. These steps should be preformed by the <systemitem
     221    class="username">root</systemitem> user each time a
     222    <application>Mozilla</application> add-on is installed. This will allow
     223    normal users to run <command>mozilla</command>. Enable multi-user operation
     224    by executing the following:</para>
     225
     226<screen role="root"><userinput>cd /usr/lib/mozilla-&mozilla-version; &amp;&amp;
    209227export LD_LIBRARY_PATH="$PWD" &amp;&amp;
    210228export MOZILLA_FIVE_HOME="$PWD" &amp;&amp;
    211229./regxpcom &amp;&amp;
    212230./regchrome &amp;&amp;
    213 touch `find . -name *.rdf`</command></userinput></screen>
    214 
    215 <note><para>You should run <command>/usr/bin/mozilla</command> once as the
    216 root user (or any user with write privileges) to create some necessary
    217 additional files in the <filename class='directory'>/usr</filename>
    218 hierarchy.</para></note>
    219 
    220 <para>Lastly, unset the build variables from the unprivileged user's
    221 environment:</para>
     231touch `find . -name *.rdf`</userinput></screen>
     232
     233    <note>
     234      <para>You should run <command>/usr/bin/mozilla</command> once as the
     235      <systemitem class="username">root</systemitem> user (or any user with
     236      write privileges) to create some necessary additional files in the
     237      <filename class='directory'>/usr</filename> hierarchy.</para>
     238    </note>
     239
     240    <para>Lastly, unset the build variables from the unprivileged user's
     241    environment:</para>
    222242
    223243<screen><userinput><command>unset MOZILLA_OFFICIAL &amp;&amp;
    224244unset BUILD_OFFICIAL &amp;&amp;
    225245unset MOZ_CO_PROJECT</command></userinput></screen>
    226 </sect2>
    227 
    228 <sect2>
    229 <title>Optional Extra Switches</title>
    230 
    231 <para>You may wish to run <command>./configure --help</command> and review
    232 each of the listed options to discover what affect they have on the build.
    233 Feel free to add or remove options to tailor the build to your desires.
    234 Listed below are some common options not listed above but can be added to
    235 the <command>configure</command> command in order to have the described effect
    236 on the <application>Mozilla</application> compile.</para>
    237 
    238 <para><option>--with-system-jpeg</option>: Uses the system-installed copy of
    239 <application>libjpeg</application> instead of the bundled copy.</para>
    240 
    241 <para><option>--enable-elf-dynstr-gc</option>: Removes un-referenced
    242 strings from <acronym>ELF</acronym> shared objects generated during the build.
    243 Note that this option breaks the build on alpha.</para>
    244 
    245 <para><option>--disable-mailnews</option>: Disables the mail and news
    246 clients.</para>
    247 
    248 <para><option>--disable-ldap</option>: Disables <acronym>LDAP</acronym>
    249 support, recommended if mail is disabled.</para>
    250 
    251 <para><option>--enable-xterm-updates</option>: Displays the current command
    252 in the <command>xterm</command> window title during the compilation.</para>
    253 
    254 <para><option>--enable-plaintext-editor-only</option>: Disables support
    255 for <acronym>HTML</acronym> editing. Do not use this switch if you are
    256 building the mail-news component.</para>
    257 
    258 </sect2>
    259 
    260 <sect2>
    261 <title>Command explanations</title>
    262 
    263 <para><command>export MOZILLA_OFFICIAL="1";
    264 export BUILD_OFFICIAL="1"</command>: Set some variables that affect what and
    265 how the package is built. These two exports specify a distribution is being
    266 built.</para>
    267 
    268 <para><parameter>--with-default-mozilla-five-home=/usr/lib/mozilla</parameter>:
    269 Sets the default value for <envar>MOZILLA_FIVE_HOME</envar>.</para>
    270 
    271 <para><parameter>--with-system-zlib --with-system-png </parameter>: Use the
    272 system-installed versions of these packages.</para>
    273 
    274 <para><parameter>--enable-application=suite</parameter>: Identifies the build
    275 as a <application>Mozilla</application> suite build.</para>
    276 
    277 <para><parameter>--enable-default-toolkit=gtk2</parameter>: Use the
    278 <acronym>GTK</acronym>2 toolkit for graphics rendering.</para>
    279 
    280 <para><parameter>--enable-extensions=all</parameter>: Enables all available
    281 extensions. If you want, you can disable any or all extensions other than the
    282 browser by changing this switch to
    283 <parameter>--enable-extensions="default,-venkman,-inspector,..."</parameter>.
    284 For a short description of the various extensions available with the
    285 <application>Mozilla</application> source, see
    286 <ulink
    287 url="http://linuxfromscratch.org/~tushar/downloads/mozilla-extensions.txt"/>.
    288 </para>
    289 
    290 <para><parameter>--enable-crypto</parameter>: Enable the Personal
    291 Security Manager to enable <acronym>SSL</acronym> connections.</para>
    292 
    293 <para><parameter>--enable-calendar</parameter>: Builds the calendar
    294 application. Removed this parameter if you don't wish to build it.</para>
    295  
    296 <para><parameter>--enable-xft; --disable-freetype2</parameter>: Enable Xft
    297 support which automatically pulls in the <application>FreeType</application>
    298 libraries.</para>
    299 
    300 <para><parameter>--enable-xinerama; --enable-optimize; --enable-reorder;
    301 --enable-strip; --enable-cpp-rtti --disable-accessibility; --disable-debug;
    302 --disable-tests; --disable-logging; --disable-pedantic;
    303 --disable-installer</parameter>: Various options that affect what components
    304 are built and some optimization options. You can pick and choose from these
    305 options. More information on them, and many other available options, can be
    306 found by running <command>./configure --help</command>.</para>
    307 
    308 <para><command>install -d /usr/include/mozilla-&mozilla-version;/nss;
    309 cp -Lf ...</command>: Copy the <acronym>NSS</acronym> interface headers that
    310 are not copied by <command>make install</command>.</para>
    311 
    312 <para><command>if [ -d /usr/lib/mozilla/plugins ] ... fi</command>: Some
    313 applications may have already installed <application>Mozilla</application>
    314 plugins. This set of commands move any existing plugins to the newly created
    315 plugin directory, then removes the existing
    316 <filename class='directory'>/usr/lib/mozilla</filename> directory.</para>
    317 
    318 <para><command>ln -nsf mozilla-&mozilla-version; ...</command>:
    319 <application>Mozilla</application> installs headers and libraries in version
    320 specific directories. These commands makes symbolic links so that applications
    321 depending on <application>Mozilla</application> (such as
    322 <application>OpenOffice</application>, <application>Galeon</application>,
    323 etc.) don't need to know which version of <application>Mozilla</application>
    324 is installed.</para>
    325 
    326 </sect2>
    327 
    328 <sect2>
    329 <title>Configuring <application>Mozilla</application></title>
    330 
    331 <para>No specific configuration is required as long as the
    332 <command>mozilla</command> script is in the user's path. If
    333 <application>Mozilla</application> is installed in a non-standard location,
    334 then make a symlink to the <command>mozilla</command> script from
    335 <filename class="directory">/usr/bin</filename>.</para>
    336 
    337 <para>Many applications look for <command>netscape</command> when they need to
    338 open a browser. You may make the following symlink for convenience (as the
    339 root user).</para>
    340 
    341 <screen><userinput role='root'><command>ln -v -sf mozilla /usr/bin/netscape</command></userinput></screen>
    342 
    343 <para>For installing various <application>Mozilla</application> plugins, refer
    344 to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's PluginDoc
    345 Project</ulink>. If you have <xref linkend="jdk"/> already installed, create
    346 the following link as the root user to utilize the
    347 <application>JAVA</application> plugin: </para>
    348 
    349 <screen><userinput role='root'><command>ln -v -s $JAVA_HOME/jre/plugin/i386/ns7/libjavaplugin_oji.so \
    350     /usr/lib/mozilla-&mozilla-version;/plugins</command></userinput></screen>
    351 </sect2>
    352 
    353 <sect2>
    354 <title>Contents</title>
    355 
    356 <segmentedlist>
    357 <segtitle>Installed Program</segtitle>
    358 <segtitle>Installed Libraries</segtitle>
    359 <segtitle>Installed Directories</segtitle>
    360 
    361 <seglistitem>
    362 <seg>mozilla</seg>
    363 <seg>Numerous libraries, browser and email/newsgroup components, plugins,
    364 extensions and helper modules installed in
    365 <filename class='directory'>/usr/lib/mozilla-&mozilla-version;</filename></seg>
    366 <seg>/usr/include/mozilla-&mozilla-version;,
    367 /usr/lib/mozilla-&mozilla-version; and
    368 /usr/share/idl/mozilla-&mozilla-version;</seg>
    369 </seglistitem>
    370 </segmentedlist>
    371 
    372 <variablelist>
    373 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    374 <?dbfo list-presentation="list"?>
    375 
    376 <varlistentry id="mozilla-prog">
    377 <term><command>mozilla</command></term>
    378 <listitem><para>is a browser/email/newsgroup/calendar/chat client suite. The
    379 various components such as the Composer, mail-news client, calendar,
    380 <acronym>IRC</acronym> chat client and address book can be accessed from the
    381 menu after <command>mozilla</command> starts or via command-line switches to
    382 the <command>mozilla</command> script. Issue <command>man mozilla</command>
    383 for additional information.</para>
    384 <indexterm zone="mozilla mozilla-prog">
    385 <primary sortas="b-mozilla">mozilla</primary>
    386 </indexterm></listitem>
    387 </varlistentry>
    388 </variablelist>
    389 
    390 </sect2>
     246
     247  </sect2>
     248
     249  <sect2 role="commands">
     250    <title>Optional Extra Switches</title>
     251
     252    <para>You may wish to run <command>./configure --help</command> and review
     253    each of the listed options to discover what affect they have on the build.
     254    Feel free to add or remove options to tailor the build to your desires.
     255    Listed below are some common options not listed above but can be added to
     256    the <command>configure</command> command in order to have the described
     257    effect on the <application>Mozilla</application> compile.</para>
     258
     259    <para><option>--with-system-jpeg</option>: Uses the system-installed copy
     260    of <application>libjpeg</application> instead of the bundled copy.</para>
     261
     262    <para><option>--enable-elf-dynstr-gc</option>: Removes un-referenced
     263    strings from ELF shared objects generated during the build. Note that this
     264    option breaks the build on alpha.</para>
     265
     266    <para><option>--disable-mailnews</option>: Disables the mail and news
     267    clients.</para>
     268
     269    <para><option>--disable-ldap</option>: Disables LDAP support, recommended
     270    if mail is disabled.</para>
     271
     272    <para><option>--enable-xterm-updates</option>: Displays the current command
     273    in the <command>xterm</command> window title during the compilation.</para>
     274
     275    <para><option>--enable-plaintext-editor-only</option>: Disables support
     276    for HTML editing. Do not use this switch if you are building the mail-news
     277    component.</para>
     278
     279  </sect2>
     280
     281  <sect2 role="commands">
     282    <title>Command Explanations</title>
     283
     284    <para><command>export MOZILLA_OFFICIAL="1";
     285    export BUILD_OFFICIAL="1"</command>: Set some variables that affect what and
     286    how the package is built. These two exports specify a distribution is being
     287    built.</para>
     288
     289    <para><parameter>--with-default-mozilla-five-home=/usr/lib/mozilla</parameter>:
     290    Sets the default value for <envar>MOZILLA_FIVE_HOME</envar>.</para>
     291
     292    <para><parameter>--with-system-zlib --with-system-png </parameter>: Use the
     293    system-installed versions of these packages.</para>
     294
     295    <para><parameter>--enable-application=suite</parameter>: Identifies the build
     296    as a <application>Mozilla</application> suite build.</para>
     297
     298    <para><parameter>--enable-default-toolkit=gtk2</parameter>: Use the
     299    GTK2 toolkit for graphics rendering.</para>
     300
     301    <para><parameter>--enable-extensions=all</parameter>: Enables all available
     302    extensions. If you want, you can disable any or all extensions other than the
     303    browser by changing this switch to
     304    <option>--enable-extensions="default,-venkman,-inspector,..."</option>.
     305    For a short description of the various extensions available with the
     306    <application>Mozilla</application> source, see
     307    <ulink
     308    url="http://linuxfromscratch.org/~tushar/downloads/mozilla-extensions.txt"/>.
     309    </para>
     310
     311    <para><parameter>--enable-crypto</parameter>: Enable the Personal
     312    Security Manager to enable SSL connections.</para>
     313
     314    <para><parameter>--enable-calendar</parameter>: Builds the calendar
     315    application. Removed this parameter if you don't wish to build it.</para>
     316
     317    <para><parameter>--enable-xft; --disable-freetype2</parameter>: Enable Xft
     318    support which automatically pulls in the <application>FreeType</application>
     319    libraries.</para>
     320
     321    <para><parameter>--enable-xinerama; --enable-optimize; --enable-reorder;
     322    --enable-strip; --enable-cpp-rtti --disable-accessibility; --disable-debug;
     323    --disable-tests; --disable-logging; --disable-pedantic;
     324    --disable-installer</parameter>: Various options that affect what components
     325    are built and some optimization options. You can pick and choose from these
     326    options. More information on them, and many other available options, can be
     327    found by running <command>./configure --help</command>.</para>
     328
     329    <para><command>install -d /usr/include/mozilla-&mozilla-version;/nss;
     330    cp -Lf ...</command>: Copy the NSS interface headers that
     331    are not copied by <command>make install</command>.</para>
     332
     333    <para><command>if [ -d /usr/lib/mozilla/plugins ] ... fi</command>: Some
     334    applications may have already installed <application>Mozilla</application>
     335    plugins. This set of commands move any existing plugins to the newly created
     336    plugin directory, then removes the existing
     337    <filename class='directory'>/usr/lib/mozilla</filename> directory.</para>
     338
     339    <para><command>ln -nsf mozilla-&mozilla-version; ...</command>:
     340    <application>Mozilla</application> installs headers and libraries in version
     341    specific directories. These commands makes symbolic links so that
     342    applications depending on <application>Mozilla</application> (such as
     343    <application>OpenOffice</application>, <application>Galeon</application>,
     344    etc.) don't need to know which version of <application>Mozilla</application>
     345    is installed.</para>
     346
     347  </sect2>
     348
     349  <sect2 role="configuration">
     350    <title>Configuring Mozilla</title>
     351
     352    <para>No specific configuration is required as long as the
     353    <command>mozilla</command> script is in the user's path. If
     354    <application>Mozilla</application> is installed in a non-standard location,
     355    then make a symlink to the <command>mozilla</command> script from
     356    <filename class="directory">/usr/bin</filename>.</para>
     357
     358    <para>Many applications look for <command>netscape</command> when they need
     359    to open a browser. You may make the following symlink for convenience (as
     360    the <systemitem class="username">root</systemitem> user).</para>
     361
     362<screen role="root"><userinput>ln -v -sf mozilla /usr/bin/netscape</userinput></screen>
     363
     364    <para>For installing various <application>Mozilla</application> plugins,
     365    refer to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's
     366    PluginDoc Project</ulink>. If you have <xref linkend="jdk"/> already
     367    installed, create the following link as the
     368    <systemitem class="username">root</systemitem> user to utilize the
     369    <application>JAVA</application> plugin: </para>
     370
     371<screen role="root"><userinput>ln -v -s $JAVA_HOME/jre/plugin/i386/ns7/libjavaplugin_oji.so \
     372    /usr/lib/mozilla-&mozilla-version;/plugins</userinput></screen>
     373
     374  </sect2>
     375
     376  <sect2 role="content">
     377    <title>Contents</title>
     378
     379    <segmentedlist>
     380      <segtitle>Installed Program</segtitle>
     381      <segtitle>Installed Libraries</segtitle>
     382      <segtitle>Installed Directories</segtitle>
     383
     384      <seglistitem>
     385        <seg>mozilla</seg>
     386        <seg>Numerous libraries, browser, and email/newsgroup components,
     387        plugins, extensions, and helper modules installed in <filename
     388        class='directory'>/usr/lib/mozilla-&mozilla-version;</filename></seg>
     389        <seg>/usr/include/mozilla-&mozilla-version;,
     390        /usr/lib/mozilla-&mozilla-version;, and
     391        /usr/share/idl/mozilla-&mozilla-version;</seg>
     392      </seglistitem>
     393    </segmentedlist>
     394
     395    <variablelist>
     396      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     397      <?dbfo list-presentation="list"?>
     398      <?dbhtml list-presentation="table"?>
     399
     400      <varlistentry id="mozilla-prog">
     401        <term><command>mozilla</command></term>
     402        <listitem>
     403          <para>is a browser/email/newsgroup/calendar/chat client suite. The
     404          various components such as the Composer, mail-news client, calendar,
     405          IRC chat client and address book can be accessed from the menu after
     406          <command>mozilla</command> starts or via command-line switches to
     407          the <command>mozilla</command> script. Issue
     408          <command>man mozilla</command> for additional information.</para>
     409          <indexterm zone="mozilla mozilla-prog">
     410            <primary sortas="b-mozilla">mozilla</primary>
     411          </indexterm>
     412        </listitem>
     413      </varlistentry>
     414
     415    </variablelist>
     416
     417  </sect2>
    391418
    392419</sect1>
Note: See TracChangeset for help on using the changeset viewer.