source: xsoft/graphweb/mozilla.xml@ 67d6349

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 67d6349 was 67d6349, checked in by Randy McMurchy <randy@…>, 19 years ago

clarified and repaired the Enigmail instructions in the Mozilla section

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

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