source: xsoft/graphweb/mozilla.xml@ b4b7337e

10.0 10.1 11.0 6.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b4b7337e was b4b7337e, checked in by Randy McMurchy <randy@…>, 17 years ago

Updated to Enigmail-0.90.1 in Mozilla and Thunderbird instructions; added indexing tags to Thunderbird

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

  • Property mode set to 100644
File size: 15.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY mozilla-download-http "http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla&mozilla-version;/source/mozilla-source-&mozilla-version;.tar.bz2">
8 <!ENTITY mozilla-download-ftp "ftp://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla&mozilla-version;/source/mozilla-source-&mozilla-version;.tar.bz2">
9 <!ENTITY mozilla-md5sum "e5994f3e801cd834966367c6a12f8aeb">
10 <!ENTITY mozilla-size "30 MB">
11 <!ENTITY mozilla-buildsize "625 MB">
12 <!ENTITY mozilla-time "13.72 SBU">
13
14 <!ENTITY mozilla-enigmail-version "0.90.1">
15 <!ENTITY mozilla-enigmail-md5sum "61deeb21ec7df10de9ad790039063f41">
16 <!ENTITY mozilla-ipc-version "1.1.2">
17 <!ENTITY mozilla-ipc-md5sum "4aa272b46c8cbf167dcd49a6d74cf526">
18]>
19
20<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
35sibling of <application>Netscape</application>. It includes the browser,
36composer, 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
40that aim to satisfy the needs of users who don't need the complete browser
41suite or prefer to have separate applications for browsing and e-mail. These
42subprojects 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
46url="http://www.mozilla.org/products/thunderbird/">Mozilla Thunderbird</ulink>,
47(a stand-alone mail client based on the <application>Mozilla</application>
48source code). The build instructions for these two applications are discussed
49in 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
59url="&mozilla-download-http;"/></para></listitem>
60<listitem><para>Download (FTP): <ulink
61url="&mozilla-download-ftp;"/></para></listitem>
62<listitem><para>Download MD5 sum (Mozilla):
63&mozilla-md5sum;</para></listitem>
64<listitem><para>Download MD5 sum (Enigmail):
65&mozilla-enigmail-md5sum;</para></listitem>
66<listitem><para>Download MD5 sum (IPC):
67&mozilla-ipc-md5sum;</para></listitem>
68<listitem><para>Download size: &mozilla-size;</para></listitem>
69<listitem><para>Estimated disk space required:
70&mozilla-buildsize;</para></listitem>
71<listitem><para>Estimated build time:
72&mozilla-time;</para></listitem></itemizedlist>
73</sect3>
74
75<sect3><title>Additional downloads</title>
76
77<para>To enable the <application>Enigmail</application> extension to the
78<application>Mozilla</application> mail client, you'll need to download the
79two tarballs below. The <application>Enigmail</application> extension allows
80users to access the authentication and encryption features provided by the
81<application>GnuPG</application> package.</para>
82
83<itemizedlist spacing='compact'>
84<listitem><para><ulink
85url="http://downloads.mozdev.org/enigmail/src/enigmail-&mozilla-enigmail-version;.tar.gz"/>
86</para></listitem>
87<listitem><para><ulink
88url="http://downloads.mozdev.org/enigmail/src/ipc-&mozilla-ipc-version;.tar.gz"/>
89</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>
102extension)</para>
103</sect4>
104
105<sect4><title>Optional</title>
106<para><xref linkend="libjpeg"/>,
107<xref linkend="unzip"/>,
108<xref linkend="gnome-vfs"/>,
109<xref linkend="libart_lgpl"/>,
110<xref linkend="heimdal"/> or <xref linkend="mitkrb"/>
111(for the GSSAPI libraries),
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
125commands:</para>
126
127<screen><userinput><command>export MOZILLA_OFFICIAL="1" &amp;&amp;
128export BUILD_OFFICIAL="1" &amp;&amp;
129./configure --prefix=/usr \
130 --with-default-mozilla-five-home=/usr/lib/mozilla \
131 --with-system-zlib \
132 --with-system-png \
133 --enable-application=suite \
134 --enable-default-toolkit=gtk2 \
135 --enable-extensions=all \
136 --enable-crypto \
137 --enable-xft \
138 --enable-xinerama \
139 --enable-optimize \
140 --enable-reorder \
141 --enable-strip \
142 --enable-cpp-rtti \
143 --enable-calendar \
144 --disable-freetype2 \
145 --disable-accessibility \
146 --disable-debug \
147 --disable-tests \
148 --disable-logging \
149 --disable-pedantic \
150 --disable-installer &amp;&amp;
151make</command></userinput></screen>
152
153<para>You should add the <option>--with-system-jpeg</option> switch to the
154<command>configure</command> script if you have
155<application>libjpeg</application> installed.</para>
156
157<para>If you're building the <application>Mozilla</application> mail and news
158clients and plan to install the <application>Enigmail</application>
159extension, execute the following steps:</para>
160
161<screen><userinput><command>tar -zxf ../enigmail-&mozilla-enigmail-version;.tar.gz -C extensions &amp;&amp;
162tar -zxf ../ipc-&mozilla-ipc-version;.tar.gz -C extensions &amp;&amp;
163build/autoconf/make-makefile extensions/ipc extensions/enigmail &amp;&amp;
164make -C extensions/ipc &amp;&amp;
165make -C extensions/enigmail</command></userinput></screen>
166
167<para>Install <application>Mozilla</application> (as the root user) as
168follows:</para>
169
170<screen><userinput role='root'><command>make install &amp;&amp;
171install -d -m755 /usr/include/mozilla-&mozilla-version;/nss &amp;&amp;
172cp -Lf dist/private/nss/*.h dist/public/nss/*.h \
173 /usr/include/mozilla-&mozilla-version;/nss &amp;&amp;
174ln -nsf mozilla-&mozilla-version; /usr/include/mozilla &amp;&amp;
175if [ -d /usr/lib/mozilla/plugins ]; then
176 mv /usr/lib/mozilla/plugins/* /usr/lib/mozilla-&mozilla-version;/plugins
177 rm -rf /usr/lib/mozilla
178fi &amp;&amp;
179ln -nsf mozilla-&mozilla-version; /usr/lib/mozilla</command></userinput></screen>
180
181<para>If you're installing the <application>Enigmail</application> extension,
182issue the following commands as the root user:</para>
183
184<screen><userinput role='root'><command>make -C extensions/ipc install &amp;&amp;
185make -C extensions/enigmail install</command></userinput></screen>
186
187<para>Some libraries, including the Netscape Portable Runtime
188(<acronym>NSPR</acronym>) and Network Security Services
189(<acronym>NSS</acronym>) libraries, installed by
190<application>Mozilla</application> are also needed by other packages. These
191libraries should be in <filename>/usr/lib</filename> so that other packages
192can link against them. As the root user, move them as follows:</para>
193
194<screen><userinput role='root'><command>for i in \
195 lib{nspr4,plc4,plds4,nss3,smime3,softokn3,ssl3}.so libsoftokn3.chk
196do
197 mv /usr/lib/mozilla-&mozilla-version;/$i /usr/lib/
198 ln -sf ../$i /usr/lib/mozilla-&mozilla-version;/
199done</command></userinput></screen>
200
201<para>Create the required component registries to enable multi-user installs.
202These steps should be preformed by the root user each time a
203<application>Mozilla</application> add-on is installed. This will allow normal
204users to run <command>mozilla</command>. Enable multi-user operation by
205executing the following:</para>
206
207<screen><userinput role='root'><command>cd /usr/lib/mozilla-&mozilla-version; &amp;&amp;
208export LD_LIBRARY_PATH="$PWD" &amp;&amp;
209export MOZILLA_FIVE_HOME="$PWD" &amp;&amp;
210./regxpcom &amp;&amp;
211./regchrome &amp;&amp;
212touch `find . -name *.rdf`</command></userinput></screen>
213
214<note><para>You should run <command>/usr/bin/mozilla</command> once as the
215root user (or any user with write privileges) to create some necessary
216additional files in the <filename class='directory'>/usr</filename>
217hierarchy.</para></note>
218
219</sect2>
220
221<sect2>
222<title>Optional Extra Switches</title>
223
224<para>You may wish to run <command>./configure --help</command> and review
225each of the listed options to discover what affect they have on the build.
226Feel free to add or remove options to tailor the build to your desires.
227Listed below are some common options not listed above but can be added to
228the <command>configure</command> command in order to have the described effect
229on the <application>Mozilla</application> compile.</para>
230
231<para><option>--with-system-jpeg</option>: Uses the system-installed copy of
232<application>libjpeg</application> instead of the bundled copy.</para>
233
234<para><option>--enable-elf-dynstr-gc</option>: Removes un-referenced
235strings from <acronym>ELF</acronym> shared objects generated during the build.
236Note that this option breaks the build on alpha.</para>
237
238<para><option>--disable-mailnews</option>: Disables the mail and news
239clients.</para>
240
241<para><option>--disable-ldap</option>: Disables <acronym>LDAP</acronym>
242support, recommended if mail is disabled.</para>
243
244<para><option>--enable-xterm-updates</option>: Displays the current command
245in the <command>xterm</command> window title during the compilation.</para>
246
247<para><option>--enable-plaintext-editor-only</option>: Disables support
248for <acronym>HTML</acronym> editing. Do not use this switch if you are
249building the mail-news component.</para>
250
251</sect2>
252
253<sect2>
254<title>Command explanations</title>
255
256<para><command>export MOZILLA_OFFICIAL="1";
257export BUILD_OFFICIAL="1"</command>: Set some variables that affect what and
258how the package is built. These two exports specify a distribution is being
259built.</para>
260
261<para><parameter>--with-default-mozilla-five-home=/usr/lib/mozilla</parameter>:
262Sets the default value for <envar>MOZILLA_FIVE_HOME</envar>.</para>
263
264<para><parameter>--with-system-zlib --with-system-png </parameter>: Use the
265system-installed versions of these packages.</para>
266
267<para><parameter>--enable-application=suite</parameter>: Identifies the build
268as a <application>Mozilla</application> suite build.</para>
269
270<para><parameter>--enable-default-toolkit=gtk2</parameter>: Use the
271<acronym>GTK</acronym>2 toolkit for graphics rendering.</para>
272
273<para><parameter>--enable-extensions=all</parameter>: Enables all available
274extensions. If you want, you can disable any or all extensions other than the
275browser by changing this switch to
276<parameter>--enable-extensions="default,-venkman,-inspector,..."</parameter>.
277For a short description of the various extensions available with the
278<application>Mozilla</application> source, see
279<ulink
280url="http://linuxfromscratch.org/~tushar/downloads/mozilla-extensions.txt"/>.
281</para>
282
283<para><parameter>--enable-crypto</parameter>: Enable the Personal
284Security Manager to enable <acronym>SSL</acronym> connections.</para>
285
286<para><parameter>--enable-calendar</parameter>: Builds the calendar
287application. Removed this parameter if you don't wish to build it.</para>
288
289<para><parameter>--enable-xft; --disable-freetype2</parameter>: Enable Xft
290support which automatically pulls in the <application>FreeType</application>
291libraries.</para>
292
293<para><parameter>--enable-xinerama; --enable-optimize; --enable-reorder;
294--enable-strip; --enable-cpp-rtti --disable-accessibility; --disable-debug;
295--disable-tests; --disable-logging; --disable-pedantic;
296--disable-installer</parameter>: Various options that affect what components
297are built and some optimization options. You can pick and choose from these
298options. More information on them, and many other available options, can be
299found by running <command>./configure --help</command>.</para>
300
301<para><command>install -d /usr/include/mozilla-&mozilla-version;/nss;
302cp -Lf ...</command>: Copy the <acronym>NSS</acronym> interface headers that
303are not copied by <command>make install</command>.</para>
304
305<para><command>if [ -d /usr/lib/mozilla/plugins ] ... fi</command>: Some
306applications may have already installed <application>Mozilla</application>
307plugins. This set of commands move any existing plugins to the newly created
308plugin directory, then removes the existing
309<filename class='directory'>/usr/lib/mozilla</filename> directory.</para>
310
311<para><command>ln -nsf mozilla-&mozilla-version; ...</command>:
312<application>Mozilla</application> installs headers and libraries in version
313specific directories. These commands makes symbolic links so that applications
314depending on <application>Mozilla</application> (such as
315<application>OpenOffice</application>, <application>Galeon</application>,
316etc.) don't need to know which version of <application>Mozilla</application>
317is installed.</para>
318
319</sect2>
320
321<sect2>
322<title>Configuring <application>Mozilla</application></title>
323
324<para>No specific configuration is required as long as the
325<command>mozilla</command> script is in the user's path. If
326<application>Mozilla</application> is installed in a non-standard location,
327then make a symlink to the <command>mozilla</command> script from
328<filename class="directory">/usr/bin</filename>.</para>
329
330<para>Many applications look for <command>netscape</command> when they need to
331open a browser. You may make the following symlink for convenience (as the
332root user).</para>
333
334<screen><userinput role='root'><command>ln -sf mozilla /usr/bin/netscape</command></userinput></screen>
335
336<para>For installing various <application>Mozilla</application> plugins, refer
337to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's PluginDoc
338Project</ulink>.</para>
339
340</sect2>
341
342<sect2>
343<title>Contents</title>
344
345<segmentedlist>
346<segtitle>Installed Program</segtitle>
347<segtitle>Installed Libraries</segtitle>
348<segtitle>Installed Directories</segtitle>
349
350<seglistitem>
351<seg>mozilla</seg>
352<seg>Numerous libraries, browser and email/newsgroup components, plugins,
353extensions and helper modules installed in
354<filename class='directory'>/usr/lib/mozilla-&mozilla-version;</filename></seg>
355<seg>/usr/include/mozilla-&mozilla-version;,
356/usr/lib/mozilla-&mozilla-version; and
357/usr/share/idl/mozilla-&mozilla-version;</seg>
358</seglistitem>
359</segmentedlist>
360
361<variablelist>
362<bridgehead renderas="sect3">Short Descriptions</bridgehead>
363<?dbfo list-presentation="list"?>
364
365<varlistentry id="mozilla-prog">
366<term><command>mozilla</command></term>
367<listitem><para>is a browser/email/newsgroup/calendar/chat client suite. The
368various components such as the Composer, mail-news client, calendar,
369<acronym>IRC</acronym> chat client and address book can be accessed from the
370menu after <command>mozilla</command> starts or via command-line switches to
371the <command>mozilla</command> script. Issue <command>man mozilla</command>
372for additional information.</para>
373<indexterm zone="mozilla mozilla-prog">
374<primary sortas="b-mozilla">mozilla</primary>
375</indexterm></listitem>
376</varlistentry>
377</variablelist>
378
379</sect2>
380
381</sect1>
Note: See TracBrowser for help on using the repository browser.