source: xsoft/graphweb/mozilla.xml@ 4d2f2f47

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 4d2f2f47 was 4d2f2f47, checked in by Randy McMurchy <randy@…>, 17 years ago

Updated to Mozilla-1.7.5

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

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