source: xsoft/graphweb/mozilla.xml@ ace3ef8

10.0 10.1 11.0 11.1 11.2 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 krejzi/svn lazarus nosym perl-modules plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since ace3ef8 was ace3ef8, checked in by Randy McMurchy <randy@…>, 19 years ago

Updated to Mozilla-1.7.1 and GnuPG-1.2.5; added patches to both packages to fix various build issues

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

  • Property mode set to 100644
File size: 15.2 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/releases/mozilla&mozilla-version;/src/mozilla-source-&mozilla-version;.tar.bz2">
8 <!ENTITY mozilla-download-ftp "ftp://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla&mozilla-version;/src/mozilla-source-&mozilla-version;.tar.bz2">
9 <!ENTITY mozilla-size "34 MB">
10 <!ENTITY mozilla-buildsize "700 MB">
11 <!ENTITY mozilla-time "10.37 SBU">
12
13 <!ENTITY enigmail-version "0.85.0">
14 <!ENTITY ipc-version "1.0.5">
15]>
16
17<sect1 id="mozilla" xreflabel="Mozilla-&mozilla-version;">
18<?dbhtml filename="mozilla.html" ?>
19<title>Mozilla-&mozilla-version;</title>
20
21<sect2>
22<title>Introduction to <application>Mozilla</application></title>
23
24<para><application>Mozilla</application> is a browser suite, the Open Source
25sibling of <application>Netscape</application>. It includes the browser,
26composer, mail and news clients, a calendar client and an
27<acronym>IRC</acronym> client.</para>
28
29<para>The <application>Mozilla</application> project also hosts two subprojects
30that aim to satisfy the needs of users who don't need the complete browser
31suite or like to have separate applications for browsing and e-mail. These
32subprojects are
33<ulink url="http://www.mozilla.org/products/firefox/">Mozilla Firefox</ulink>,
34(a stand-alone browser based on the
35<application>Mozilla</application> source code) and <ulink
36url="http://www.mozilla.org/projects/thunderbird/">Mozilla Thunderbird</ulink>,
37(a stand-alone mail client based on the <application>Mozilla</application>
38source code). The build instructions for these two applications are discussed
39in separate sections:</para>
40
41<itemizedlist>
42<listitem><para><xref linkend="firefox"/></para></listitem>
43<listitem><para><xref linkend="thunderbird"/></para></listitem>
44</itemizedlist>
45
46<sect3><title>Package information</title>
47<itemizedlist spacing='compact'>
48<listitem><para>Download (HTTP): <ulink
49url="&mozilla-download-http;"/></para></listitem>
50<listitem><para>Download (FTP): <ulink
51url="&mozilla-download-ftp;"/></para></listitem>
52<listitem><para>Download size: &mozilla-size;</para></listitem>
53<listitem><para>Estimated Disk space required:
54&mozilla-buildsize;</para></listitem>
55<listitem><para>Estimated build time:
56&mozilla-time;</para></listitem></itemizedlist>
57</sect3>
58
59<sect3><title>Additional downloads</title>
60<itemizedlist spacing='compact'>
61<listitem><para>Required Patch: <ulink
62url="&patch-root;/mozilla-&mozilla-version;-freetype_fix-1.patch"/></para>
63</listitem></itemizedlist>
64
65<para>To enable the <application>Enigmail</application> extension to the
66<application>Mozilla</application> and <application>Thunderbird</application>
67mail clients, you'll need to download the two tarballs below. The
68<application>Enigmail</application> extension allows users to access the
69authentication and encryption features provided by the
70<application>GnuPG</application> package.</para>
71
72<itemizedlist spacing='compact'>
73<!-- <listitem><para><ulink url="http://enigmail.mozdev.org/">Enigmail Extension
74(Version &enigmail-version;)</ulink>
75(Useful only if Mozilla Mail is built)</para></listitem>
76<listitem><para><ulink url="http://enigmail.mozdev.org/">Inter Process
77Communicaton Extension (Version &ipc-version;)</ulink>
78(Needed for Enigmail)</ulink></para></listitem> -->
79
80<listitem><para><ulink
81url="http://downloads.mozdev.org/enigmail/src/enigmail-&enigmail-version;.tar.gz"/>
82</para></listitem>
83<listitem><para><ulink
84url="http://downloads.mozdev.org/enigmail/src/ipc-&ipc-version;.tar.gz"/>
85</para></listitem>
86</itemizedlist>
87</sect3>
88
89<sect3><title><application>Mozilla</application> dependencies</title>
90<sect4><title>Required</title>
91<para><xref linkend="zip"/>, <xref linkend="GTK2"/>, <xref linkend="libIDL"/>,
92<xref linkend="libmng"/> and <xref linkend="which"/></para></sect4>
93<sect4><title>Recommended</title>
94<para><xref linkend="gnupg"/> (for Enigmail extension)</para></sect4>
95<sect4><title>Optional</title>
96<para><xref linkend="gnome-vfs"/>, <xref linkend="libart_lgpl"/>,
97<xref linkend="heimdal"/> or <xref linkend="mitkrb"/>
98(for the GSSAPI libraries),
99<ulink url="http://www.hpl.hp.com/personal/Hans_Boehm/gc/">GC</ulink> and
100<ulink url="http://www.stack.nl/~dimitri/doxygen/">doxygen</ulink>
101</para></sect4>
102</sect3>
103
104</sect2>
105
106<sect2>
107<title>Installation of <application>Mozilla</application></title>
108
109<!--
110<note>
111<para>According to the financial institutions, the following hack makes your
112browser insecure. You have been warned. Many sites use an MS-IE specific tag
113(autocomplete=off) to prevent autocomplete from working in some forms. This
114tag is now supported in <application>Mozilla</application> to appease
115the financial institutions. As per
116the requirements of the financial institutions, they will not even accept a
117solution where this a preference option. However our opinion is that it should
118be in the hands of the user. To enable autocomplete to bypass
119this restriction, we need to make a slight modification in the code.</para>
120
121<para>Open the file <filename>extensions/wallet/src/wallet.cpp</filename> in
122the <application>Mozilla</application> source tree and search for the line:
123<screen>#define WALLET_DONT_CACHE_ALL_PASSWORDS</screen>
124Then delete or comment out the line. Now, if anyone tells you MS-IE is user
125friendly, give them this example!</para>
126</note>
127-->
128
129<warning><para>Do not install <application>Mozilla</application>,
130<application>Mozilla Firefox</application> and
131<application>Mozilla Thunderbird</application> with a single prefix since they
132install identically named files. The <acronym>BLFS</acronym> Book installs
133<application>Mozilla</application> in <filename>/usr</filename> while
134<application>Mozilla Firefox</application> and
135<application>Mozilla Thunderbird</application> are installed in
136<filename>/opt</filename>.</para></warning>
137
138<para>Compile <application>Mozilla</application> by running the following
139commands:</para>
140
141<screen><userinput><command>export MOZILLA_OFFICIAL="1" &amp;&amp;
142export BUILD_OFFICIAL="1" &amp;&amp;
143patch -Np1 -i ../mozilla-&mozilla-version;-freetype_fix-1.patch &amp;&amp;
144./configure --prefix=/usr \
145 --with-default-mozilla-five-home=/usr/lib/mozilla \
146 --enable-default-toolkit=gtk2 \
147 --with-x --with-system-zlib \
148 --with-system-jpeg --with-system-png --with-system-mng \
149 --enable-xft --enable-crypto \
150 --disable-accessibility \
151 --disable-tests --disable-debug \
152 --disable-logging --enable-reorder \
153 --enable-strip --disable-pedantic \
154 --enable-cpp-rtti --enable-extensions=all &amp;&amp;
155make</command></userinput></screen>
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-&enigmail-version;.tar.gz -C extensions &amp;&amp;
162tar zxf ../ipc-&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 &amp;&amp;
166make -C extensions/enigmail/build xpi &amp;&amp;
167make -C extensions/enigmail/package xpi</command></userinput></screen>
168
169<para>Install <application>Mozilla</application> as follows:</para>
170
171<screen><userinput><command>make install &amp;&amp;
172install -d /usr/include/mozilla-&mozilla-version;/nss &amp;&amp;
173cp -Lf dist/private/nss/*.h dist/public/nss/*.h \
174 /usr/include/mozilla-&mozilla-version;/nss &amp;&amp;
175ln -nsf mozilla-&mozilla-version; /usr/include/mozilla &amp;&amp;
176ln -nsf mozilla-&mozilla-version; /usr/lib/mozilla</command></userinput></screen>
177
178<para>Some libraries installed by <application>Mozilla</application> are also
179needed by other packages. These libraries should be in
180<filename>/usr/lib</filename> so that other packages can link against them.
181Move them as follows:</para>
182
183<screen><userinput><command>for i in lib{nspr4,plc4,plds4,nss3,smime3,softokn3,ssl3}.so libsoftokn3.chk
184do
185 mv /usr/lib/mozilla-&mozilla-version;/$i /usr/lib/
186 ln -sf ../$i /usr/lib/mozilla-&mozilla-version;/
187done</command></userinput></screen>
188
189<para>Install the <application>Enigmail</application> extension as
190follows:</para>
191
192<screen><userinput><command>make -C extensions/ipc install &amp;&amp;
193make -C extensions/enigmail install</command></userinput></screen>
194
195<para>To enable multi-user operation, execute the following:</para>
196
197<screen><userinput><command>cd /usr/lib/mozilla-&mozilla-version; &amp;&amp;
198export LD_LIBRARY_PATH="/usr/lib/mozilla-&mozilla-version;" &amp;&amp;
199export MOZILLA_FIVE_HOME="/usr/lib/mozilla-&mozilla-version;" &amp;&amp;
200./regxpcom &amp;&amp;
201./regchrome &amp;&amp;
202touch `find /usr/lib/mozilla-&mozilla-version; -name *.rdf`</command></userinput></screen>
203
204</sect2>
205
206<sect2>
207<title>Optional Extra Switches</title>
208
209<para>Each of these switches can be added to the configure line in order to
210have the described effect on the <application>Mozilla</application>
211compile.</para>
212
213<para><option>--enable-elf-dynstr-gc</option>: Removes un-referenced
214strings from <acronym>ELF</acronym> shared objects generated during the build.
215Note that this option breaks the build on alpha.</para>
216
217<para><option>--disable-mailnews</option>: Disable the mail and news
218clients.</para>
219
220<para><option>--disable-ldap</option>: Disable <acronym>LDAP</acronym>
221support, recommended if mail is disabled.</para>
222
223<para><option>--enable-calendar</option>: Build the calendar client.</para>
224
225<para><option>--enable-xterm-updates</option>: This option is for enabling
226the <command>xterm</command> window title with the current command when
227compiling.</para>
228
229<para><option>--enable-plaintext-editor-only</option>: Disable support
230for <acronym>HTML</acronym> editing. Do not use this switch if you are
231building the mail-news component.</para>
232
233</sect2>
234
235<sect2>
236<title>Command explanations</title>
237
238<para><screen><command>export MOZILLA_OFFICIAL="1" &amp;&amp;
239export BUILD_OFFICIAL="1"</command></screen>
240Set some variables that affect what and how the package is built. These two
241exports specify a distribution is being built.</para>
242
243<!--
244<para> The last export specifies that we
245are ok with the <acronym>LGPL</acronym> versioned libart.</para>
246-->
247
248<para><parameter>--prefix=/usr</parameter>: Previously
249<application>Mozilla</application> did not support the <command>make
250install</command> option. Hence, the package was installed in
251<filename>/opt</filename>. The package now supports
252"<command>make install</command>" and follows the <acronym>FHS</acronym>
253guidelines for installation. Therefore the book now recommends installation
254in a system wide prefix such as <filename>/usr</filename>.</para>
255
256<para><screen><option>--enable-default-toolkit=gtk2</option></screen>
257Use the gtk2 toolkit.</para>
258
259<para><screen><option>--with-system-zlib --with-system-jpeg \
260--with-system-png --with-system-mng</option></screen>
261Use the system installed versions of these packages.</para>
262
263<para><option>--enable-xft</option>: Enable Xft support. You need
264<application>fontconfig</application> or the latest
265<application>XFree86</application> version to enable Xft.</para>
266
267<para><option>--enable-crypto</option>: Enable the Personal
268Security Manager to enable <acronym>SSL</acronym> connections.</para>
269
270<para><screen><option>--disable-jsd --disable-accessibility \
271--disable-tests --disable-debug \
272--disable-dtd-debug \
273--disable-logging --enable-reorder \
274--enable-strip \
275--enable-cpp-rtti</option></screen>
276Various options that affect what components are built and some optimization
277options. You can pick and choose from these options. More information on them
278can be found in the <application>Mozilla</application>
279<command>configure</command> script help. Not all options are used in the
280instructions given above.</para>
281
282<para><option>--enable-extensions=...</option>: Enables extensions. If you
283want, you can disable all extensions other than the browser by changing this
284switch to
285<parameter>--enable-extensions="default,-venkman,-inspector,-irc"</parameter>.
286For a short description of the various extensions available with the
287<application>Mozilla</application> source, see
288<ulink
289url="http://linuxfromscratch.org/~tushar/downloads/mozilla-extensions.txt"/>.
290</para>
291
292<para><screen><command>install -d /usr/include/mozilla-&mozilla-version;/nss
293cp -Lf dist/private/nss/*.h dist/public/nss/*.h \
294 /usr/include/mozilla-&mozilla-version;/nss</command></screen>
295Copy the nss headers that are not copied by make install.</para>
296
297<!--
298<para><userinput>install -d /usr/lib/mozilla-&mozilla-version;/openoffice</userinput> :
299Make a directory to store static libraries that openoffice needs during compilation.
300These libraries are not installed by default.</para>
301-->
302
303<para><command>ln -nsf mozilla-&mozilla-version; ...</command>:
304<application>Mozilla</application> installs headers and libraries in version
305specific directories. This command 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<para><screen><command>export LD_LIBRARY_PATH="/usr/lib/mozilla-&mozilla-version;" &amp;&amp;
312export MOZILLA_FIVE_HOME="/usr/lib/mozilla-&mozilla-version;" &amp;&amp;
313./regxpcom &amp;&amp;
314./regchrome &amp;&amp;
315touch `find /usr/lib/mozilla-${VERSION} -name *.rdf`</command>
316</screen>
317Create the required component registries to enable multi-user installs. These
318steps should be preformed by the root user each time a
319<application>Mozilla</application> add-on is installed. This will allow normal
320users to run <command>mozilla</command>.</para>
321
322</sect2>
323
324<sect2>
325<title>Configuring <application>Mozilla</application></title>
326
327<para>No specific configuration is required as long as the
328<command>mozilla</command> binary is in the path for the user. If
329<application>Mozilla</application> is installed in a non-standard location,
330then make a symlink to the <command>mozilla</command> binary from
331<filename class="directory">/usr/bin</filename>. The same thing applies for
332<application>Mozilla Firefox</application> and
333<application>Mozilla Thunderbird</application>.</para>
334
335<para>Many applications look for <command>netscape</command> when they need to
336open a browser. You may make the following symlink for convenience.</para>
337
338<screen><userinput><command>ln -sf mozilla /usr/bin/netscape</command></userinput></screen>
339
340<para>For installing various <application>Mozilla</application> plugins, refer
341to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's PluginDoc
342Project</ulink>.</para>
343
344</sect2>
345
346<sect2>
347<title>Contents</title>
348
349<para>The <application>Mozilla</application> package contains
350<command>mozilla</command> and the <application>Mozilla</application>
351libraries and plugins. The various components such as composer and mail-news
352can be accessed from the menu after <command>mozilla</command> starts or
353via command-line switches to the <command>mozilla</command> binary.
354</para>
355
356</sect2>
357
358</sect1>
Note: See TracBrowser for help on using the repository browser.