source: xsoft/graphweb/seamonkey.xml@ 79a1f36c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.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
Last change on this file since 79a1f36c was 6067373, checked in by DJ Lucas <dj@…>, 18 years ago

Updated OpenOffice to new system-moz patch and added notes to moz product pages about OOo and system NSS.

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

  • Property mode set to 100644
File size: 27.5 KB
RevLine 
[f939f05]1<?xml version="1.0" encoding="ISO-8859-1"?>
[ff769b8c]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
[f939f05]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[0aeb696]7 <!-- Inserted as a reminder to do this. The mention of a test suite
8 is usually right before the root user installation commands. Please
9 delete these 12 (including one blank) lines after you are done.-->
10
11 <!-- Use one of the two mentions below about a test suite,
12 delete the line that is not applicable. Of course, if the
13 test suite uses syntax other than "make check", revise the
14 line to reflect the actual syntax to run the test suite -->
15
16 <!-- <para>This package does not come with a test suite.</para> -->
17 <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
18
[b5eb704]19 <!ENTITY mozilla-download-http "http://ftp.mozilla.org/pub/mozilla.org/seamonkey/releases/&seamonkey-version;/seamonkey-&seamonkey-version;.source.tar.bz2">
20 <!ENTITY mozilla-download-ftp "ftp://ftp.mozilla.org/pub/mozilla.org/seamonkey/releases/&seamonkey-version;/seamonkey-&seamonkey-version;.source.tar.bz2">
[38b68577]21 <!ENTITY mozilla-md5sum "6921464b5251cafd529c04c2b9f98d5f">
22 <!ENTITY mozilla-size "34.0 MB">
23 <!ENTITY mozilla-buildsize "615 MB">
24 <!ENTITY mozilla-time "15.0 SBU">
[7f588e9a]25
[b5eb704]26 <!ENTITY mozilla-enigmail-version "0.94.0">
[7f588e9a]27 <!ENTITY mozilla-enigmail-download "http://www.mozilla-enigmail.org/downloads/src/enigmail-&mozilla-enigmail-version;.tar.gz">
[b5eb704]28 <!ENTITY mozilla-enigmail-md5sum "d326c302c1d2d68217fffcaa01ca7632">
[f939f05]29]>
30
[d59969b]31<sect1 id="seamonkey" xreflabel="SeaMonkey-&seamonkey-version;">
[b5eb704]32 <?dbhtml filename="seamonkey.html" ?>
[88dd2f52]33
34 <sect1info>
35 <othername>$LastChangedBy$</othername>
36 <date>$Date$</date>
[d1f23e0]37 <keywordset>
[b5eb704]38 <keyword role="package">seamonkey-&seamonkey-version;-source.tar</keyword>
39 <keyword role="ftpdir">seamonkey</keyword>
[d1f23e0]40 </keywordset>
[88dd2f52]41 </sect1info>
42
[d59969b]43 <title>SeaMonkey-&seamonkey-version;</title>
[88dd2f52]44
[b5eb704]45 <indexterm zone="seamonkey">
[d59969b]46 <primary sortas="a-SeaMonkey">SeaMonkey</primary>
[88dd2f52]47 </indexterm>
48
49 <sect2 role="package">
[d59969b]50 <title>Introduction to SeaMonkey</title>
[88dd2f52]51
[d59969b]52 <para><application>SeaMonkey</application> is a browser suite, the Open
[88dd2f52]53 Source sibling of <application>Netscape</application>. It includes the
54 browser, composer, mail and news clients, a calendar client and an
[b5eb704]55 IRC client. It is the follow-on to the Mozilla browser suite.</para>
56
57 <para>The Mozilla project also hosts two subprojects that aim to satisfy
58 the needs of users who don't need the complete browser suite or prefer to
59 have separate applications for browsing and e-mail. These subprojects are
60 <ulink url="http://www.mozilla.com/firefox/">Mozilla Firefox</ulink>, (a
61 stand-alone browser based on the <application>Mozilla</application> source
62 code) and <ulink url="http://www.mozilla.com/thunderbird/">Mozilla
63 Thunderbird</ulink>, (a stand-alone mail/newsgroup client based on the
64 <application>Mozilla</application> source code). The build instructions for
65 these two applications are discussed in separate sections:</para>
[88dd2f52]66
67 <itemizedlist>
68 <listitem>
69 <para><xref linkend="firefox"/></para>
70 </listitem>
71 <listitem>
72 <para><xref linkend="thunderbird"/></para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Package Information</bridgehead>
77 <itemizedlist spacing="compact">
78 <listitem>
79 <para>Download (HTTP): <ulink url="&mozilla-download-http;"/></para>
80 </listitem>
81 <listitem>
82 <para>Download (FTP): <ulink url="&mozilla-download-ftp;"/></para>
83 </listitem>
84 <listitem>
85 <para>Download MD5 sum: &mozilla-md5sum;</para>
86 </listitem>
87 <listitem>
88 <para>Download size: &mozilla-size;</para>
89 </listitem>
90 <listitem>
91 <para>Estimated disk space required: &mozilla-buildsize;</para>
92 </listitem>
93 <listitem>
94 <para>Estimated build time: &mozilla-time;</para>
95 </listitem>
96 </itemizedlist>
[d59969b]97
[88dd2f52]98 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
[15e255f]99 <itemizedlist spacing="compact">
100 <listitem>
[d59969b]101 <para>Required patch (if using system-wide NSS/NSPR provided by
102 <xref linkend="nss"/>): <ulink
103 url="&patch-root;/seamonkey-&seamonkey-version;-system_nss-1.patch"/>
[7f588e9a]104 </para>
[15e255f]105 </listitem>
106 </itemizedlist>
[bccbdaea]107
[b5eb704]108 <para>To enable the <application>Enigmail</application> extension to the
[d59969b]109 <application>SeaMonkey</application> mail client, you'll need to download
110 the tarball listed below. The <application>Enigmail</application> extension
111 allows users to access the authentication and encryption features provided
112 by the <application>GnuPG</application> package. The
[7f588e9a]113 <application>Enigmail</application> extension will not operate correctly
114 unless you have <xref linkend="gnupg"/> installed.</para>
[88dd2f52]115
116 <itemizedlist spacing='compact'>
117 <listitem>
[7f588e9a]118 <para><ulink url="&mozilla-enigmail-download;"/></para>
[88dd2f52]119 </listitem>
120 <listitem>
121 <para>Download MD5 sum (Enigmail): &mozilla-enigmail-md5sum;</para>
122 </listitem>
123 </itemizedlist>
124
[d59969b]125 <bridgehead renderas="sect3">SeaMonkey Dependencies</bridgehead>
[88dd2f52]126
127 <bridgehead renderas="sect4">Required</bridgehead>
[b5eb704]128 <para role="required">
129 <xref linkend="gtk2"/>,
130 <xref linkend="libidl"/>, and
131 <xref linkend="zip"/>
132 </para>
133
134 <note>
[d59969b]135 <para><xref linkend="libjpeg"/> should have been installed before
136 <application>GTK+</application> and should exist on your system. If
[b5eb704]137 for some reason you haven't installed <application>libjpeg</application>,
138 you should remove the <option>--with-system-jpeg</option> option from the
139 <filename>.mozconfig</filename> file created below.</para>
140 </note>
141
142 <bridgehead renderas="sect4">Recommended</bridgehead>
143 <para role="recommended">
[d59969b]144 <xref linkend="nss"/> (if you will be installing any other package that
145 utilizes NSS/NSPR, such as <application>Firefox</application>,
[6067373]146 <application>Thunderbird</application>,
147 <application>Evolution</application>, or
148 <application>OpenOffice</application>)
[b5eb704]149 </para>
[88dd2f52]150
151 <bridgehead renderas="sect4">Optional</bridgehead>
[b5eb704]152 <para role="optional">
[d59969b]153 <xref linkend="unzip"/> and
154 <xref linkend="libgnomeui"/> (to build the gnomevfs extension)
[b5eb704]155 </para>
[88dd2f52]156
[38e4f06]157 <para condition="html" role="usernotes">User Notes:
158 <ulink url="&blfs-wiki;/seamonkey"/></para>
159
[88dd2f52]160 </sect2>
161
162 <sect2 role="installation">
[d59969b]163 <title>Installation of SeaMonkey</title>
[88dd2f52]164
[d59969b]165 <para>The configuration of <application>SeaMonkey</application> is
[7f588e9a]166 accomplished by creating a <filename>.mozconfig</filename> file containing
167 the desired configuration options. A default <filename>.mozconfig</filename>
168 file is created below. To see the entire list of available configuration
169 options (and an abbreviated description of each one), issue
170 <command>./configure --help</command>. Additional information can also be
171 found below in the section titled <xref linkend="add-mozconfig"/>. If you
172 are going to use system-installed versions of the
173 <application>NSS</application> and <application>NSPR</application>
[d59969b]174 libraries, ensure you uncomment the two lines near the bottom of the file. If
[7f588e9a]175 you would prefer to download the file instead of creating it by typing or
176 cut-and-pasting, you can find it at <ulink
[b5eb704]177 url="&files-anduin;/seamonkey-&seamonkey-version;-mozconfig"/>
[7f588e9a]178 (the file must be installed in the root of the source tree
179 <filename class='directory'>mozilla</filename> directory, and named
180 <filename>.mozconfig</filename>). Create the file by issuing the following
181 command:</para>
182
183<screen><userinput>cat &gt; .mozconfig &lt;&lt; "EOF"
[d59969b]184<literal># This file contains the options used in the SeaMonkey build. You may
185# need to specify additional options for your specific build needs.
186# Use the information provided by running './configure --help' to
187# help you determine if you need to add any additional options.
188# Some additional options can be added by uncommenting the examples
189# in this file or adding options by inserting a line containing
190# 'ac_add_options --some-option-you-need'.
191
192
193# Create an object directory and specify to build the package in that
194# directory. If desired, modify the location of the object directory
195# to a directory inside the source tree by removing '../' from the
196# line below.
197mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../seamonkey-build
198
199# This option is used to specify that the SeaMonkey suite is
200# being built and to use all the default options for SeaMonkey.
[7f588e9a]201ac_add_options --enable-application=suite
[d59969b]202
203# Specify the installation prefix. If you would prefer SeaMonkey
204# installed in a different prefix, modify the line below to fit
205# your needs. You'll also need to modify some of the instructions in
206# the BLFS book to point to your desired prefix.
[7f588e9a]207ac_add_options --prefix=/usr
208
[d59969b]209# These options are used so that the SeaMonkey binaries are linked to
210# the system-installed copies of the specified libraries instead of
211# the source tree code which may not be the most recent versions.
[7f588e9a]212ac_add_options --with-system-zlib
213ac_add_options --with-system-png
214ac_add_options --with-system-jpeg
[d59969b]215ac_add_options --enable-system-cairo
[7f588e9a]216
[d59969b]217# This option specifies to include support for rendering the HTML
218# &lt;canvas&gt;&lt;/canvas&gt; tag in the SeaMonkey browser.
219ac_add_options --enable-canvas
220
221# This option is used so that the debugging symbols are removed from
222# the installed binaries during the installation process. Comment out
223# this option if you may have a need to retain the debugging symbols
224# in the installed binaries. Note that this can substantially
225# increase the size of the installed binaries.
[7f588e9a]226ac_add_options --enable-strip
[d59969b]227
228# This option is added so that test libraries and programs are not
229# built. These would only be required for debugging purposes.
[7f588e9a]230ac_add_options --disable-tests
[d59969b]231
232# This option is added so that the Mozilla Installer program is not
233# built or installed. The program is not required for a BLFS
234# installation of SeaMonkey.
[7f588e9a]235ac_add_options --disable-installer
[d59969b]236
237# This option is used to disable the a11y support in the SeaMonkey
238# binaries. Comment out this option if you require a11y support.
[7f588e9a]239ac_add_options --disable-accessibility
240
[d59969b]241# This option is used to enable support for rendering SVG files in the
242# SeaMonkey browser.
243ac_add_options --enable-svg
244
245# This option is used to enable source tree included LDAP support in
246# the SeaMonkey binaries.
[7f588e9a]247ac_add_options --enable-ldap
[d59969b]248
249# This option is used to enable the calendar program in the
250# SeaMonkey suite.
[7f588e9a]251ac_add_options --enable-calendar
252
[d59969b]253# These two options enable support for building SeaMonkey with
254# system-installed versions of the Network Security Services (NSS)
255# and Netscape Portable Runtime (NSPR) libraries. Uncomment both
256# lines to enable support for system-installed NSS/NSPR.
[7f588e9a]257#ac_add_options --with-system-nspr
[d59969b]258#ac_add_options --with-system-nss
259
260# Uncomment this option if you desire support for dual-monitor
261# display of SeaMonkey using the X-Window Xinerama libraries.
262#ac_add_options --enable-xinerama
263
264# This option identifies the default binary directory of the SeaMonkey
265# installation and is used to locate SeaMonkey's installed files. This
266# option is not required for end-user browsing, and is only used for
267# development purposes.
268#ac_add_options --with-default-mozilla-five-home=/usr/lib/seamonkey-1.0</literal>
[7f588e9a]269
270EOF</userinput></screen>
[d59969b]271
[7f588e9a]272 <para>If you have system-installed Network Security Services (NSS) and
273 Netscape Portable Runtime (NSPR) libraries and you uncommented the
274 appropriate lines in the <filename>.mozconfig</filename> file to utilize
275 them, apply the following patch:</para>
276
[b5eb704]277<screen><userinput>patch -Np1 -i ../seamonkey-&seamonkey-version;-system_nss-1.patch</userinput></screen>
[d59969b]278
279 <para>Compile <application>SeaMonkey</application> by running the
280 following command:</para>
[88dd2f52]281
[b5eb704]282<screen><userinput>make -f client.mk build</userinput></screen>
[7f588e9a]283
[d59969b]284 <para>If you're building the <application>SeaMonkey</application>
[7f588e9a]285 mail/newsgroup client and plan to install the
286 <application>Enigmail</application> extension, issue the following
287 commands:</para>
[f939f05]288
[b5eb704]289<screen><userinput>tar -xf ../enigmail-&mozilla-enigmail-version;.tar.gz -C mailnews/extensions &amp;&amp;
[7f588e9a]290
[d59969b]291pushd mailnews/extensions/enigmail &amp;&amp;
[7f588e9a]292./makemake -r &amp;&amp;
[d59969b]293popd &amp;&amp;
[7f588e9a]294
[d59969b]295make -C ../seamonkey-build/mailnews/extensions/enigmail &amp;&amp;
296make -C ../seamonkey-build/mailnews/extensions/enigmail xpi</userinput></screen>
[7f588e9a]297
[d59969b]298 <para>Install <application>SeaMonkey</application> by issuing the following
[7f588e9a]299 commands as the <systemitem class="username">root</systemitem> user:</para>
300
301<screen role="root"><userinput>make -f client.mk install &amp;&amp;
302
[d59969b]303install -v -m644 ../seamonkey-build/dist/public/ldap-private/* \
[b5eb704]304 /usr/include/seamonkey-&seamonkey-version;/ldap &amp;&amp;
[7f588e9a]305
[b5eb704]306install -v -m755 -d /usr/lib/seamonkey-&seamonkey-version;/defaults/isp/US &amp;&amp;
[7f588e9a]307install -v -m644 mailnews/base/ispdata/movemail.rdf \
[b5eb704]308 /usr/lib/seamonkey-&seamonkey-version;/defaults/isp &amp;&amp;
309ln -v -s ../movemail.rdf /usr/lib/seamonkey-&seamonkey-version;/defaults/isp/US</userinput></screen>
[5dc41f0]310
[d59969b]311 <para>If you built <application>SeaMonkey</application> utilizing
[7f588e9a]312 system-installed NSS and NSPR libraries, the
[b5eb704]313 <filename>seamonkey-ns*.pc</filename> <application>pkgconfig</application>
[4694b140]314 files are broken as they point to the wrong directories where the actual
315 libraries and interface headers are located. Issue the following commands
316 as the <systemitem class="username">root</systemitem> user to replace the
317 broken files with symbolic links to known good files:</para>
[6473e74]318
[b5eb704]319<screen role="root"><userinput>ln -v -sf nss.pc /usr/lib/pkgconfig/seamonkey-nss.pc &amp;&amp;
320ln -v -sf nspr.pc /usr/lib/pkgconfig/seamonkey-nspr.pc</userinput></screen>
[7f588e9a]321
322 <para>If you did <emphasis role="strong">NOT</emphasis> build
[b5eb704]323 <application>seamonkey</application> utilizing system-installed NSS and
[7f588e9a]324 NSPR libraries, issue the following commands as the
325 <systemitem class="username">root</systemitem> user to install the NSS
326 interface headers:</para>
327
[b5eb704]328<screen role="root"><userinput>install -v -m755 -d /usr/include/seamonkey-&seamonkey-version;/nss &amp;&amp;
[d59969b]329cp -v -Lf ../seamonkey-build/dist/{private,public}/nss/*.h \
[b5eb704]330 /usr/include/seamonkey-&seamonkey-version;/nss</userinput></screen>
[7f588e9a]331
332 <para>If you built the <application>Enigmail</application> extension,
333 issue the following commands as the <systemitem
334 class="username">root</systemitem> user to install the
335 <filename>.xpi</filename> file into the
[b5eb704]336 <filename class='directory'>/usr/lib/seamonkey-&seamonkey-version;</filename>
[7f588e9a]337 directory:</para>
338
[b5eb704]339<screen role="root"><userinput>install -v -m755 -d /usr/lib/seamonkey-&seamonkey-version;/xpi_store &amp;&amp;
[d59969b]340install -v -m644 ../seamonkey-build/dist/bin/enigmail-&mozilla-enigmail-version;-*.xpi \
[b5eb704]341 /usr/lib/seamonkey-&seamonkey-version;/xpi_store</userinput></screen>
[7f588e9a]342
343 <para>There are two methods you can use to install the
344 <application>Enigmail</application> extension. Both are shown here and
[d59969b]345 provide similar functionality with one major difference. The first
346 method will install the extension system-wide and all users of SeaMonkey
347 will have an Enigmail-enabled mail client. The method shown later only
348 installs it on a per-user basis. The first method must be accomplished
[7f588e9a]349 now (before the object directory is removed) and uses the conventional
350 <command>make install</command> command to install the
351 <application>Enigmail</application> files straight from the distribution
[d59969b]352 directory of the object directory. The alternate method is shown as it
[7f588e9a]353 installs using the <filename class='extension'>.xpi</filename> file
354 created earlier and can be done later (at any time you desire) as the
355 file used to install <application>Enigmail</application> was copied into
356 <filename
[b5eb704]357 class='directory'>/usr/lib/seamonkey-&seamonkey-version;/xpi_store</filename>
[7f588e9a]358 in the previous step. This method can be used to install any
359 downloaded <application>Mozilla</application> extension distributed in a
360 <filename class='extension'>.xpi</filename> file. There are many
[d59969b]361 extensions available for <application>SeaMonkey</application>. A list
[7f588e9a]362 containing many of them can be found at
363 <ulink url="http://extensionroom.mozdev.org/"/>.</para>
364
365 <para>If you want to install the <application>Enigmail</application>
[d59969b]366 extension now, which offers system-wide access, issue the following
367 commands as the <systemitem class="username">root</systemitem> user:</para>
[d1981e0]368
[d59969b]369<screen role="root"><userinput>make -C ../seamonkey-build/mailnews/extensions/enigmail install</userinput></screen>
[7f588e9a]370
371 <para>To install an extension from a created or download
372 <filename class='extension'>.xpi</filename> file, you simply need to
373 <quote>open</quote> the <filename class='extension'>.xpi</filename> file
374 using the <quote>Open File</quote> option of the <quote>File</quote>
[d59969b]375 menu of the browser window. You can browse to find the file (for example,
[7f588e9a]376 the <application>Enigmail</application>
377 <filename class='extension'>.xpi</filename> file is located in
378 <filename
[b5eb704]379 class='directory'>/usr/lib/seamonkey-&seamonkey-version;/xpi_store</filename>),
[7f588e9a]380 select it, then follow the prompts to install the extension.</para>
381
[88dd2f52]382 <note>
[b5eb704]383 <para>You should run <command>/usr/bin/seamonkey</command> once as the
[88dd2f52]384 <systemitem class="username">root</systemitem> user (or any user with
385 write privileges) to create some necessary additional files in the
[7f588e9a]386 <filename class='directory'>/usr</filename> hierarchy. Also do this
[d59969b]387 each time you install additional system-wide extensions.</para>
[88dd2f52]388 </note>
[f939f05]389
[88dd2f52]390 </sect2>
391
[7f588e9a]392 <sect2 role="commands" id="add-mozconfig"
393 xreflabel="Additional .mozconfig Options">
[88dd2f52]394
[7f588e9a]395 <title>Additional .mozconfig Options</title>
[88dd2f52]396
[7f588e9a]397 <para>Information about some of the additional options which can be added
398 to the <filename>.mozconfig</filename> configuration file is shown below.
399 Note that this is just a few of the options. You may wish to run
400 <command>./configure --help</command> and review each of the listed options
401 to discover what affect they have on the build. Feel free to add or remove
402 options to tailor the build to your desires. Listed below are some common
403 options not in the default <filename>.mozconfig</filename> file but can be
[d59969b]404 added in order to have the described effect on the SeaMonkey compile.</para>
[6473e74]405
[7f588e9a]406 <para><option>ac_add_options --enable-elf-dynstr-gc</option>: Removes
407 un-referenced strings from ELF shared objects generated during the build.
408 Note that this option breaks the build on alpha.</para>
[88dd2f52]409
[7f588e9a]410 <para><option>ac_add_options --disable-mailnews</option>: Disables the mail
411 and news clients.</para>
[88dd2f52]412
[7f588e9a]413 <para><option>ac_add_options --disable-ldap</option>: Disables LDAP support,
414 recommended if mail is disabled.</para>
[88dd2f52]415
[7f588e9a]416 <para><option>ac_add_options --enable-xterm-updates</option>: Displays the
417 current command in the <command>xterm</command> window title during the
418 compilation.</para>
[88dd2f52]419
[7f588e9a]420 <para><option>ac_add_options --enable-plaintext-editor-only</option>:
421 Disables support for HTML editing. Do not use this switch if you are
422 building the mail-news component.</para>
[88dd2f52]423
424 </sect2>
425
426 <sect2 role="commands">
[7f588e9a]427 <title>.mozconfig Option Explanations</title>
428
429 <para>To simplify reading the options below, they are labeled without
430 <parameter>ac_add_options</parameter> inserted at the beginning of the
[d59969b]431 option. These options are also described in the
432 <filename>.mozconfig</filename> file created earlier.</para>
[88dd2f52]433
[7f588e9a]434 <para><parameter>mk_add_options
[d59969b]435 MOZ_OBJDIR=@TOPSRCDIR@/../seamonkey-build</parameter>: Creates an object
[7f588e9a]436 directory and specifies to build the package in that directory. If desired,
437 modify the location of the object directory to a directory inside the
438 source tree by removing <quote>../</quote> from the line.</para>
[88dd2f52]439
[7f588e9a]440 <para><parameter>--enable-application=suite</parameter>: Identifies the
[d59969b]441 build as a <application>SeaMonkey</application> suite build.</para>
[88dd2f52]442
[7f588e9a]443 <para><parameter>--with-system-zlib --with-system-png
[d59969b]444 --with-system-jpeg --enable-system-cairo</parameter>: Uses the
445 system-installed versions of these packages.</para>
[88dd2f52]446
447 <para><parameter>--enable-calendar</parameter>: Builds the calendar
[7f588e9a]448 application. Remove this parameter if you don't wish to build it.</para>
[88dd2f52]449
[d59969b]450 <para><parameter>--enable-xinerama --enable-reorder --enable-strip
451 --enable-cpp-rtti --disable-accessibility --disable-tests --disable-logging
452 --disable-pedantic --disable-installer</parameter>: Various options that
453 affect what components are built and some optimization options. You can
454 pick and choose from these options. More information on them, and many
455 other available options, can be found by running
456 <command>./configure --help</command>.</para>
[88dd2f52]457
[7f588e9a]458 </sect2>
459
460 <sect2 role="commands">
461 <title>Command Explanations</title>
462
463 <para><command>make -f client.mk ...</command>: Mozilla products are
464 packaged to allow the use of a configuration file which can be used to
465 pass the configuration settings to the <command>configure</command>
466 command. <command>make</command> uses the <filename>client.mk</filename>
467 file to get initial configuration and setup parameters, then depending on
468 the target parameter (<parameter>build</parameter> or
469 <parameter>install</parameter>), either runs the
470 <command>configure</command> script and compiles the package or installs
471 the package.</para>
472
473 <para><command>./makemake -r</command>: This command is used to recursively
[b5eb704]474 create <filename>Makefile</filename>s in the appropriate subdirectory
[d59969b]475 of seamonkey-build.</para>
[7f588e9a]476
477 <para><command>make -C ... xpi</command>: This command builds the
478 <application>Enigmail</application>
479 <filename class='extension'>.xpi</filename> file which can be used to
480 install <application>Enigmail</application>.</para>
481
482 <para><command>install .../movemail.rdf ...</command>: This
483 command is used to install a file inadvertently left out of the
484 installation script.</para>
[88dd2f52]485
486 </sect2>
487
488 <sect2 role="configuration">
[d59969b]489 <title>Configuring SeaMonkey</title>
[88dd2f52]490
491 <para>No specific configuration is required as long as the
[b5eb704]492 <command>seamonkey</command> script is in the user's path. If
[d59969b]493 <application>SeaMonkey</application> is installed in a non-standard location,
[b5eb704]494 then make a symlink to the <command>seamonkey</command> script in the
[7f588e9a]495 <filename class="directory">/usr/bin</filename> directory.</para>
[88dd2f52]496
497 <para>Many applications look for <command>netscape</command> when they need
498 to open a browser. You may make the following symlink for convenience (as
499 the <systemitem class="username">root</systemitem> user).</para>
500
[b5eb704]501<screen role="root"><userinput>ln -v -sf seamonkey /usr/bin/netscape</userinput></screen>
[88dd2f52]502
[d59969b]503 <para>For installing various <application>SeaMonkey</application> plugins,
[88dd2f52]504 refer to <ulink url="http://plugindoc.mozdev.org/linux.html">Mozdev's
505 PluginDoc Project</ulink>. If you have <xref linkend="jdk"/> already
506 installed, create the following link as the
507 <systemitem class="username">root</systemitem> user to utilize the
508 <application>JAVA</application> plugin: </para>
509
510<screen role="root"><userinput>ln -v -s $JAVA_HOME/jre/plugin/i386/ns7/libjavaplugin_oji.so \
[b5eb704]511 /usr/lib/seamonkey-&seamonkey-version;/plugins</userinput></screen>
[88dd2f52]512
[d59969b]513 <para>Some packages install SeaMonkey plugins into the default system-wide
[5dc41f0]514 directory <filename class='directory'>/usr/lib/mozilla/plugins</filename>.
[d59969b]515 If desired, create symbolic links in the <application>SeaMonkey</application>
[5dc41f0]516 plugin directory
[b5eb704]517 <filename class='directory'>/usr/lib/seamonkey-&seamonkey-version;/plugins</filename>
[5dc41f0]518 to the files in the default plugin directory (you should link to the actual
519 files and not other links). Alternatively, you can move or copy the files
520 in the default plugin directory to the
[d59969b]521 <application>SeaMonkey</application> plugin directory. An example of creating
[5dc41f0]522 a symbolic link is shown below. Create the links as the
523 <systemitem class="username">root</systemitem> user:</para>
524
[38e4f06]525<screen role="root"><userinput>ln -v -s ../../seamonkey/plugins/<replaceable>&lt;plugin.so&gt;</replaceable> \
[b5eb704]526 /usr/lib/seamonkey-&seamonkey-version;/plugins</userinput></screen>
[5dc41f0]527
[7f588e9a]528 <para>Along with using the <quote>Preferences</quote> menu to configure
[d59969b]529 <application>SeaMonkey</application>'s options and preferences to suit
[7f588e9a]530 individual tastes, finer grain control of many options is only available
531 using a tool not available from the general menu system. To access this
[d59969b]532 tool, you'll need to open a browser window and enter
[7f588e9a]533 <systemitem role='url'>about:config</systemitem> in the
534 address bar. This will display a list of the configuration preferences and
535 information related to each one. You can use the <quote>Filter:</quote> bar
536 to enter search criteria and narrow down the listed items. Changing a
537 preference can be done using two methods. One, if the preference has a
538 boolean value (True/False), simply double-click on the preference to toggle
539 the value and two, for other preferences simply right-click on the desired
540 line, choose <quote>Modify</quote> from the menu and change the value.
541 Creating new preference items is accomplished in the same way, except
542 choose <quote>New</quote> from the menu and provide the desired data into
543 the fields when prompted.</para>
544
545 <tip>
546 <para>There is a multitude of configuration parameters you can tweak to
[d59969b]547 customize <application>SeaMonkey</application>. A very extensive and
[7f588e9a]548 up-to-date list of these parameters can be found at <ulink
549 url="http://preferential.mozdev.org/preferences.html"/>.</para>
550 </tip>
551
[88dd2f52]552 </sect2>
553
554 <sect2 role="content">
555 <title>Contents</title>
556
557 <segmentedlist>
[7f588e9a]558 <segtitle>Installed Programs</segtitle>
[88dd2f52]559 <segtitle>Installed Libraries</segtitle>
560 <segtitle>Installed Directories</segtitle>
561
562 <seglistitem>
[b5eb704]563 <seg>seamonkey and seamonkey-config</seg>
[88dd2f52]564 <seg>Numerous libraries, browser, and email/newsgroup components,
565 plugins, extensions, and helper modules installed in <filename
[b5eb704]566 class='directory'>/usr/lib/seamonkey-&seamonkey-version;</filename></seg>
567 <seg>/usr/include/seamonkey-&seamonkey-version;,
568 /usr/lib/seamonkey-&seamonkey-version;, and
569 /usr/share/idl/seamonkey-&seamonkey-version;</seg>
[88dd2f52]570 </seglistitem>
571 </segmentedlist>
572
573 <variablelist>
574 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
575 <?dbfo list-presentation="list"?>
576 <?dbhtml list-presentation="table"?>
577
[b5eb704]578 <varlistentry id="seamonkey-prog">
579 <term><command>seamonkey</command></term>
[88dd2f52]580 <listitem>
581 <para>is a browser/email/newsgroup/calendar/chat client suite. The
582 various components such as the Composer, mail-news client, calendar,
583 IRC chat client and address book can be accessed from the menu after
[b5eb704]584 <command>seamonkey</command> starts or via command-line switches to
585 the <command>seamonkey</command> script. Issue
586 <command>man seamonkey</command> for additional information.</para>
587 <indexterm zone="seamonkey seamonkey-prog">
588 <primary sortas="b-seamonkey">seamonkey</primary>
[88dd2f52]589 </indexterm>
590 </listitem>
591 </varlistentry>
592
593 </variablelist>
594
595 </sect2>
[f45b1953]596
597</sect1>
Note: See TracBrowser for help on using the repository browser.