r5588 - in trunk/BOOK: . introduction/welcome xsoft/other

randy at linuxfromscratch.org randy at linuxfromscratch.org
Mon Jan 23 15:32:53 PST 2006


Author: randy
Date: 2006-01-23 16:32:52 -0700 (Mon, 23 Jan 2006)
New Revision: 5588

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/xsoft/other/thunderbird.xml
Log:
Updated to Thunderbird-1.5 and changed the build method to use 'client.mk' and '.mozconfig'

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2006-01-23 23:29:05 UTC (rev 5587)
+++ trunk/BOOK/general.ent	2006-01-23 23:32:52 UTC (rev 5588)
@@ -490,7 +490,7 @@
 <!ENTITY dillo-version                "0.8.5">
 
 <!-- Chapter 36 -->
-<!ENTITY thunderbird-version          "1.0.6">
+<!ENTITY thunderbird-version          "1.5">
 <!ENTITY pan-version                  "0.14.2">
 <!ENTITY balsa-version                "2.3.6">
 <!ENTITY gaim-version                 "1.5.0">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2006-01-23 23:29:05 UTC (rev 5587)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2006-01-23 23:32:52 UTC (rev 5588)
@@ -45,6 +45,10 @@
       <para>January 23rd, 2006</para>
       <itemizedlist>
         <listitem>
+          <para>[randy] - Updated to Thunderbird-1.5 and changed the build
+          method to use 'client.mk' and '.mozconfig'.</para>
+        </listitem>
+        <listitem>
           <para>[randy] - Added information about using system-installed
           versions of the NSS libraries and added additional configuration
           information to the Firefox instructions.</para>

Modified: trunk/BOOK/xsoft/other/thunderbird.xml
===================================================================
--- trunk/BOOK/xsoft/other/thunderbird.xml	2006-01-23 23:29:05 UTC (rev 5587)
+++ trunk/BOOK/xsoft/other/thunderbird.xml	2006-01-23 23:32:52 UTC (rev 5588)
@@ -6,32 +6,16 @@
 
   <!ENTITY thunderbird-download-http     "http://ftp.mozilla.org/pub/mozilla.org/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;-source.tar.bz2">
   <!ENTITY thunderbird-download-ftp      "ftp://ftp.mozilla.org/pub/mozilla.org/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;-source.tar.bz2">
-  <!ENTITY thunderbird-md5sum            "a0ddcc8bd5ee2c9be724b6963ad27111">
-  <!ENTITY thunderbird-size              "33.3 MB">
-  <!ENTITY thunderbird-buildsize         "560 MB">
-  <!ENTITY thunderbird-time              "10.3 SBU">
+  <!ENTITY thunderbird-md5sum            "781c1cd1a01583d9b666d8c2fe4288e6">
+  <!ENTITY thunderbird-size              "35.0 MB">
+  <!ENTITY thunderbird-buildsize         "597 MB">
+  <!ENTITY thunderbird-time              "18.1 SBU">
 
-  <!ENTITY thunderbird-enigmail-version  "0.92.0">
-  <!ENTITY thunderbird-enigmail-download "http://downloads.mozdev.org/enigmail/src/enigmail-&thunderbird-enigmail-version;.tar.gz">
-  <!ENTITY thunderbird-enigmail-md5sum   "50c369ce6d6fcb2d275cd30319a601ff">
-
-  <!ENTITY thunderbird-ipc-version       "1.1.3">
-  <!ENTITY thunderbird-ipc-download      "http://downloads.mozdev.org/enigmail/src/ipc-&thunderbird-ipc-version;.tar.gz">
-  <!ENTITY thunderbird-ipc-md5sum        "64ba4c6e3b52568468c4f6680ec7e679">
+  <!ENTITY thunderbird-enigmail-version  "0.94.0">
+  <!ENTITY thunderbird-enigmail-download "http://www.mozilla-enigmail.org/downloads/src/enigmail-&thunderbird-enigmail-version;.tar.gz">
+  <!ENTITY thunderbird-enigmail-md5sum   "d326c302c1d2d68217fffcaa01ca7632">
 ]>
 
-<!--
-
-Devs:
-
-Always check the mail/config/mozconfig file in the source tree for
-any changes to the options passed to configure. This file shows the
-default build used by Mozilla. BLFS adds to this, but the values here
-should be in our setup. The stuff about ActiveX can be ignored as
-that is Windows crap only.
-
--->
-
 <sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
   <?dbhtml filename="thunderbird.html" ?>
 
@@ -82,57 +66,53 @@
     <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     <itemizedlist spacing="compact">
       <listitem>
-        <para>Required patch: <ulink
-        url="&patch-root;/thunderbird-&thunderbird-version;-gcc4-2.patch"/></para>
+        <para>Required patch (if using system-installed versions of
+        <application>NSS</application> and <application>NSPR</application>:)
+        <ulink
+        url="&patch-root;/thunderbird-&thunderbird-version;-system_nss-1.patch"/>
+        </para>
       </listitem>
-      <listitem>
-        <para>Required patch: <ulink
-        url="&patch-root;/thunderbird-&thunderbird-version;-fixes-1.patch"/></para>
-      </listitem>
     </itemizedlist>
 
     <para>To enable the <application>Enigmail</application> extension to the
     <application>Thunderbird</application> mail client, you'll need to download
-    the two tarballs below. The <application>Enigmail</application> extension
+    the tarball shown below. The <application>Enigmail</application> extension
     allows users to access the authentication and encryption features provided
-    by the <application>GnuPG</application> package.</para>
+    by the <application>GnuPG</application> package. The Enigmail extension
+    will not operate correctly unless you have <xref linkend="gnupg"/>
+    installed.</para>
 
     <itemizedlist spacing='compact'>
       <listitem>
         <para><ulink url="&thunderbird-enigmail-download;"/></para>
       </listitem>
       <listitem>
-        <para>Download MD5 sum (Enigmail): &thunderbird-enigmail-md5sum;</para>
+        <para>Download MD5 sum: &thunderbird-enigmail-md5sum;</para>
       </listitem>
-      <listitem>
-        <para><ulink url="&thunderbird-ipc-download;"/></para>
-      </listitem>
-      <listitem>
-        <para>Download MD5 sum (IPC): &thunderbird-ipc-md5sum;</para>
-      </listitem>
     </itemizedlist>
 
     <bridgehead renderas="sect3">Thunderbird Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Required</bridgehead>
-    <para role="required"><xref linkend="zip"/>,
-    <xref linkend="gtk2"/> and
-    <xref linkend="libidl"/></para>
+    <para role="required"><xref linkend="gtk2"/>,
+    <xref linkend="libidl"/>, and
+    <xref linkend="zip"/></para>
 
-    <bridgehead renderas="sect4">Recommended</bridgehead>
-    <para role="recommended"><xref linkend="gnupg"/> (run-time only dependency
-    for the <application>Enigmail</application> extension)</para>
+    <para>Note: <application>libjpeg</application> should have been installed
+    before <application>GTK+</application> and should exist on your system. If
+    for some reason you haven't installed <application>libjpeg</application>,
+    you should remove the <option>--with-system-jpeg</option> option from the
+    <filename>.mozconfig</filename> file created below.</para>
 
+    <bridgehead renderas="sect4">Recommended (if you will be installing any
+    other package that utilizes NSS/NSPR, such as
+    <application>Firefox</application> or
+    <application>Mozilla</application>)</bridgehead>
+    <para role="recommended"><xref linkend="nss"/></para>
+
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><xref linkend="libjpeg"/>,
-    <xref linkend="unzip"/>,
-    <xref linkend="gnome-vfs"/>,
-    <xref linkend="libgnome"/>,
-    <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>
-    (for the GSSAPI libraries),
-    <xref linkend="doxygen"/>,
-    <ulink url="http://xprint.mozdev.org/">Xprint</ulink>,
-    <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink></para>
+    <para role="optional"><xref linkend="unzip"/> and
+    <xref linkend="libgnomeui"/> (to build the gnomevfs extension)</para>
 
   </sect2>
 
@@ -140,71 +120,146 @@
     <title>Installation of Thunderbird</title>
 
     <para>The configuration of <application>Thunderbird</application> is
-    very similar to <xref linkend="mozilla"/> and hence the options will not
-    be discussed. Refer to the <xref linkend="mozilla"/> instructions for
-    explanations and additional configuration information.</para>
+    accomplished by creating a <filename>.mozconfig</filename> file containing
+    the desired configuration options. A default <filename>.mozconfig</filename>
+    is created below. To see the entire list of available configuration options
+    (and an abbreviated description of each one), issue
+    <command>./configure --help</command>. If you are going to use
+    system-installed versions of the <application>NSS</application> and
+    <application>NSPR</application> libraries, ensure you uncomment the two
+    lines near the bottom of the file. You may also wish to review the entire
+    file and uncomment any other desired options. If you would prefer to
+    download the file instead of creating it by typing or cut-and-pasting, you
+    can find it at <ulink
+    url="http://anduin.linuxfromscratch.org/files/BLFS/thunderbird-&thunderbird-version;-mozconfig"/>
+    (the file must be installed in the root of the source tree
+    <filename class='directory'>mozilla</filename> directory, and named
+    <filename>.mozconfig</filename>). Create the file by issuing the following
+    command:</para>
 
+<screen><userinput>cat > .mozconfig << "EOF"
+<literal># This file contains the options used in the Thunderbird build. You may
+# need to specify additional options for your specific build needs.
+# Use the information provided by running './configure --help' to
+# help you determine if you need to add any additional options.
+# Some additional options can be added by uncommenting the examples
+# in this file or adding options by inserting a line containing
+# 'ac_add_options --some-option-you-need'.
+
+
+# Use the default settings specified in the source tree
+. $topsrcdir/mail/config/mozconfig
+
+# Create an object directory and specify to build the package in that
+# directory. If desired, modify the location of the object directory
+# to a directory inside the source tree by removing '../' from the
+# line below.
+mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../thunderbird-build
+
+# Specify the installation prefix. If you would prefer Thunderbird
+# installed in a different prefix, modify the line below to fit
+# your needs. You'll also need to modify some of the instructions in
+# the BLFS book to point to your desired prefix.
+ac_add_options --prefix=/usr
+
+# These options are used so that the Thunderbird binaries are linked to
+# the system-installed copies of the specified libraries instead of
+# the source tree code which may not be the most recent versions.
+ac_add_options --with-system-zlib
+ac_add_options --with-system-png
+ac_add_options --with-system-jpeg
+ac_add_options --enable-system-cairo
+
+# This option causes the installed binaries to have the official
+# Thunderbird name embedded in them. Due to license restrictions, you
+# may not distribute binaries created using this option.
+ac_add_options --enable-official-branding
+
+# This option specifies to include support for rendering the HTML
+# <canvas></canvas> tag in the Thunderbird mail client.
+#ac_add_options --enable-canvas
+
+# This option is used so that the debugging symbols are removed from
+# the installed binaries during the installation process. Comment out
+# this option if you may have a need to retain the debugging symbols
+# in the installed binaries. Note that this can substantially
+# increase the size of the installed binaries.
+ac_add_options --enable-strip
+
+# This option is added so that test libraries and programs are not
+# built. These would only be required for debugging purposes.
+ac_add_options --disable-tests
+
+# This option is added so that the Mozilla Installer program is not
+# built or installed. The program is not required for a BLFS
+# installation of Thunderbird.
+ac_add_options --disable-installer
+
+# This option is used to disable the a11y support in the Thunderbird
+# binaries. Comment out this option if you require a11y support.
+ac_add_options --disable-accessibility
+
+# This option is used to enable source tree included LDAP support in
+# the Thunderbird binaries.
+ac_add_options --enable-ldap
+
+# This option is used to enable support for rendering SVG files in the
+# Thunderbird mail client. Uncomment the line below to enable the option.
+#ac_add_options --enable-svg
+
+# Uncomment this option if you desire support for dual-monitor
+# display of Thunderbird using the X-Window Xinerama libraries.
+#ac_add_options --enable-xinerama
+
+# These two options enable support for building Thunderbird with
+# system-installed versions of the Network Security Services (NSS)
+# and Netscape Portable Runtime (NSPR) libraries. Uncomment both
+# lines to enable support for system-installed NSS/NSPR.
+#ac_add_options --with-system-nss
+#ac_add_options --with-system-nspr
+
+# This option identifies the default binary directory of the Thunderbird
+# installation and is used to locate Thunderbird's installed files. This
+# option is not required for end-user use, and is only used for
+# development purposes.
+#ac_add_options --with-default-mozilla-five-home=/usr/lib/thunderbird-&thunderbird-version;</literal>
+
+EOF</userinput></screen>
+
+    <para>If you have system-installed Network Security Services (NSS) and
+    Netscape Portable Runtime (NSPR) libraries and you uncommented the
+    appropriate lines in the <filename>.mozconfig</filename> file to utilize
+    them, apply the following patch:</para>
+
+<screen><userinput>patch -Np1 -i ../thunderbird-&thunderbird-version;-system_nss-1.patch</userinput></screen>
+
     <para>Compile <application>Thunderbird</application> by
-    running the following commands:</para>
+    issuing the following commands:</para>
 
-<screen><userinput>export MOZILLA_OFFICIAL="1" &&
-export BUILD_OFFICIAL="1" &&
-export MOZ_THUNDERBIRD="1" &&
-patch -Np1 -i ../thunderbird-&thunderbird-version;-gcc4-2.patch &&
-patch -Np1 -i ../thunderbird-&thunderbird-version;-fixes-1.patch &&
-./configure --prefix=/usr \
-            --with-default-mozilla-five-home=/usr/lib/thunderbird-&thunderbird-version; \
-            --with-user-appdir=.thunderbird \
-            --with-system-zlib \
-            --with-system-png \
-            --enable-application=mail \
-            --enable-default-toolkit=gtk2 \
-            --enable-extensions=wallet,spellcheck,xmlextras,webservices \
-            --enable-crypto \
-            --enable-xft \
-            --enable-xinerama \
-            --enable-optimize \
-            --enable-reorder \
-            --enable-strip \
-            --enable-cpp-rtti \
-            --enable-single-profile \
-            --enable-necko-protocols=http,file,jar,viewsource,res,data \
-            --enable-image-decoders=default,-xbm \
-            --disable-freetype2 \
-            --disable-accessibility \
-            --disable-debug \
-            --disable-tests \
-            --disable-logging \
-            --disable-pedantic \
-            --disable-installer \
-            --disable-profilesharing \
-            --disable-mathml \
-            --disable-oji \
-            --disable-plugins \
-            --disable-necko-disk-cache &&
-make</userinput></screen>
+<screen><userinput>sed -i "s/^    enum$/& xptinfo_enum_1/" \
+    xpcom/reflect/xptinfo/public/xptinfo.h &&
+make -f client.mk build</userinput></screen>
 
-    <para>You should add the <option>--with-system-jpeg</option> switch
-    to the <command>configure</command> script if you have
-    <application>libjpeg</application> installed.</para>
-
     <para>If you're building the <application>Enigmail</application> extension,
-    execute the following steps:</para>
+    issue the following commands:</para>
 
-<screen><userinput>tar -xf ../enigmail-&thunderbird-enigmail-version;.tar.gz -C extensions &&
-tar -xf ../ipc-&thunderbird-ipc-version;.tar.gz -C extensions &&
-build/autoconf/make-makefile extensions/ipc extensions/enigmail &&
-make -C extensions/ipc &&
-make -C extensions/enigmail &&
-make -C extensions/enigmail xpi</userinput></screen>
+<screen><userinput>tar -xf ../enigmail-&thunderbird-enigmail-version;.tar.gz -C mailnews/extensions &&
+cd mailnews/extensions/enigmail &&
 
+./makemake -r &&
+cd ../../.. &&
+
+make -C ../thunderbird-build/mailnews/extensions/enigmail &&
+make -C ../thunderbird-build/mailnews/extensions/enigmail xpi</userinput></screen>
+
     <para>Install <application>Thunderbird</application> by running the following
     commands as the <systemitem class="username">root</systemitem> user:</para>
 
-<screen role="root"><userinput>make install &&
-install -v -m755 -d /usr/include/thunderbird-&thunderbird-version;/nss &&
-cp -v -Lf dist/private/nss/*.h dist/public/nss/*.h \
-    /usr/include/thunderbird-&thunderbird-version;/nss &&
+<screen role="root"><userinput>make -f client.mk install &&
+
+install -v -m644 ../thunderbird-build/dist/public/ldap-private/* \
+    /usr/include/thunderbird-1.5/ldap &&
+
 install -v -m755 -d /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/US &&
 install -v -m644 mailnews/base/ispdata/movemail.rdf \
                  mail/extensions/newsblog/rss.rdf \
@@ -212,14 +267,55 @@
 ln -v -s ../{movemail,rss}.rdf \
     /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/US</userinput></screen>
 
-    <para>If you're installing the <application>Enigmail</application> extension,
+    <para>If you built <application>Thunderbird</application> utilizing
+    system-installed NSS and NSPR libraries, the
+    <filename>thunderbird-ns*.pc</filename> <application>pkgconfig</application>
+    files need to be modified. Issue the following command as the
+    <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>sed -i 's|/thunderbird-1.5||' /usr/lib/pkgconfig/thunderbird-ns*.pc</userinput></screen>
+
+    <para>If you did <emphasis role="strong">NOT</emphasis> build
+    <application>Thunderbird</application> utilizing system-installed NSS and
+    NSPR libraries, issue the following commands as the
+    <systemitem class="username">root</systemitem> user to install the NSS
+    interface headers:</para>
+
+<screen role="root"><userinput>install -v -m755 -d /usr/include/thunderbird-&thunderbird-version;/nss &&
+cp -v -Lf ../thunderbird-build/dist/{private,public}/nss/*.h \
+    /usr/include/thunderbird-&thunderbird-version;/nss</userinput></screen>
+
+    <para>If you built the <application>Enigmail</application> extension,
     issue the following commands as the <systemitem
-    class="username">root</systemitem> user:</para>
+    class="username">root</systemitem> user to install the
+    <filename>.xpi</filename> file:</para>
 
-<screen role="root"><userinput>install -v -m755 -d /usr/lib/thunderbird-&thunderbird-version;/extensions &&
-install -v -m644 dist/bin/enigmail-&thunderbird-enigmail-version;-linux-*.xpi \
-    /usr/lib/thunderbird-&thunderbird-version;/extensions</userinput></screen>
+<screen role="root"><userinput>ENIGMAIL_FILENAME=$(basename \
+    `ls ../thunderbird-build/dist/bin/enigmail-&thunderbird-enigmail-version;-*.xpi`) &&
 
+install -v -m644 -D ../thunderbird-build/dist/bin/$ENIGMAIL_FILENAME \
+    usr/lib/thunderbird-1.5/xpi_store/$ENIGMAIL_FILENAME</userinput></screen>
+
+    <para>If you want to install <application>Enigmail</application> globally
+    so that all users who run <application>Thunderbird</application> will have
+    access to the extension, issue the command shown below. Note that this
+    procedure starts an instance of <application>Thunderbird</application> and
+    you must have an X server running. Issue the following command as the
+    <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>/usr/bin/thunderbird -install-global-extension \
+    /usr/lib/thunderbird-&thunderbird-version;/xpi_store/$ENIGMAIL_FILENAME</userinput></screen>
+
+    <para>Global installation of other extensions can be done using the same
+    basic method as the <application>Enigmail</application> extension. See the
+    <quote>Configuring Thunderbird</quote> section below for information about
+    configuring <application>Enigmail</application> for individual users if you
+    did not not install it globally.</para>
+
+    <!-- This appears to not be required any longer. The regchrome program
+         is not built any longer, and multi-user access to Thunderbird appears
+         to work fine without running regxpcom and touching the files. -Randy 
+
     <para>To enable multi-user operation, execute the following as the
     <systemitem class="username">root</systemitem> user:</para>
 
@@ -230,6 +326,8 @@
 ./regchrome &&
 touch `find . -name *.rdf`</userinput></screen>
 
+    -->
+
     <note>
       <para>You should run <command>/usr/bin/thunderbird</command> once as the
       <systemitem class="username">root</systemitem> user (or any user with
@@ -238,30 +336,37 @@
       directory.</para>
     </note>
 
-    <para>Finally, unset the build variables from the unprivileged user's
-    environment:</para>
-
-<screen><userinput>unset MOZILLA_OFFICIAL &&
-unset BUILD_OFFICIAL &&
-unset MOZ_THUNDERBIRD</userinput></screen>
-
   </sect2>
 
   <sect2 role="commands">
     <title>Command Explanations</title>
 
-    <para><command>patch -Np1 -i ...</command>: This patch fixes three major
-    issues with the <application>Thunderbird</application> installation. First,
-    it moves the installation of the <filename>prefs.js</filename> file from
-    <filename class='directory'>/usr/bin/defaults/profile</filename> to
-    <filename class='directory'>/usr/lib/thunderbird-&thunderbird-version;/defaults/profile</filename>,
-    it fixes a profile locking problem if the <command>thunderbird</command>
-    script is called when <application>Thunderbird</application> is already
-    running and last, makes it so that if a
-    <computeroutput>mailto:</computeroutput> URL is clicked, a message
-    compose window will open with the <computeroutput>To:</computeroutput>
-    field filled out.</para>
+    <para><command>sed -i "s/^    enum$/& xptinfo_enum_1/" ...</command>:
+    This command is used to fix an anonymous enum in an external/public
+    interface header file.</para>
 
+    <para><command>make -f client.mk ...</command>: Mozilla products are
+    packaged to allow the use of a configuration file which can be used to 
+    pass the configuration settings to the <command>configure</command>
+    command. <command>make</command> uses the <filename>client.mk</filename>
+    file to get initial configuration and setup parameters, then depending on
+    the target parameter (<parameter>build</parameter> or
+    <parameter>install</parameter>), either runs the
+    <command>configure</command> script and compiles the package or installs
+    the package.</para>
+
+    <para><command>./makemake -r</command>: This command is used to recursively
+    create <filename>Makefile</filename>s in the current directory.</para>
+
+    <para><command>make -C ... xpi</command>: This command builds the
+    <application>Enigmail</application>
+    <filename class='extension'>.xpi</filename> file which is used to install
+    <application>Enigmail</application>.</para>
+
+    <para><command>install .../movemail.rdf .../rss.rdf ...</command>: These
+    commands are used to install two files inadvertently left out of the
+    installation script.</para>
+
   </sect2>
 
   <sect2 role="configuration">
@@ -269,14 +374,25 @@
 
     <sect3><title>Configuration Information</title>
 
-      <para>Configuration of <application>Thunderbird</application> to use the
-      <application>Enigmail</application> extension must be done on an
-      as-needed basis for each user of the system who may use
-      <application>Thunderbird</application>. It is accomplished through the
-      <application>Thunderbird</application> <quote>Tools</quote> menu. Choose
-      the <quote>Extensions</quote> – <quote>Install</quote> option and
-      fill in the <quote>Look in:</quote> field with
-      <filename class='directory'>/usr/lib/thunderbird-&thunderbird-version;/extensions</filename>.
+      <para>No specific configuration is required as long as the
+      <command>thunderbird</command> script is in the user's path. If
+      <application>Thunderbird</application> is installed in a non-standard
+      location, then make a symlink to the <command>thunderbird</command>
+      script in the <filename class="directory">/usr/bin</filename>
+      directory.</para>
+
+      <para>If you don't have privileges to install extensions globally, or
+      you prefer to not install global extensions, you can configure
+      <application>Thunderbird</application> on an individual user basis for
+      access to extensions. For example, if you built the
+      <application>Enigmail</application> extension and did not install it
+      globally, it can be installed on an as-needed basis for each user of the
+      system who may use <application>Thunderbird</application>. It is
+      accomplished through the <application>Thunderbird</application>
+      <quote>Tools</quote> menu. Choose the <quote>Extensions</quote> –
+      <quote>Install</quote> option and fill in the <quote>Look in:</quote>
+      field with <filename
+      class='directory'>/usr/lib/thunderbird-&thunderbird-version;/xpi_store</filename>.
       You'll then see the
       <filename>enigmail-&thunderbird-enigmail-version;-linux-????.xpi</filename>
       file listed. Choose this file and click on <quote>Open</quote>, then
@@ -284,6 +400,43 @@
       <application>Enigmail</application> extension will install and you will
       be prompted to restart <application>Thunderbird</application>.</para>
 
+      <para>If your Window or Desktop Manager does not allow you to configure
+      a default browser, you can add a configuration parameter to 
+      <application>Thunderbird</application> so that a browser will start when
+      when you click on an Internet/intranet/local URL. The procedure to check
+      or modify any of the configuration parameters is quite simple and the
+      instructions here can be used to view or modify any of the
+      parameters.</para>
+
+      <para>First, open the configuration dialog by opening the
+      <quote>Edit</quote> drop-down menu. Choose <quote>Preferences</quote>
+      and then click on the <quote>Advanced</quote> icon on the top menu
+      bar. Choose the <quote>General</quote> tab and click on the
+      <quote>Config Editor</quote> button. This will display a list of the
+      configuration preferences and information related to each one. You can
+      use the <quote>Filter:</quote> bar to enter search criteria and narrow
+      down the listed items. Changing a preference can be done using two
+      methods. One, if the preference has a boolean value (True/False), simply
+      double-click on the preference to toggle the value and two, for other
+      preferences simply right-click on the desired line, choose
+      <quote>Modify</quote> from the menu and change the value. Creating new
+      preference items is accomplished in the same way, except choose
+      <quote>New</quote> from the menu and provide the desired data into the
+      fields when prompted.</para>
+
+      <para>The configuration preference item you need to check so that
+      <application>Thunderbird</application> uses a specified browser is the
+      <parameter>network.protocol-handler.app.http</parameter> which should
+      be set to the path of the desired browser, e.g.,
+      <option>/usr/bin/firefox</option>.</para>
+
+    <tip>
+      <para>There is a multitude of configuration parameters you can tweak to
+      customize <application>Thunderbird</application>. A very extensive and
+      up-to-date list of these parameters can be found at <ulink
+      url="http://preferential.mozdev.org/preferences.html"/>.</para>
+    </tip>
+
     </sect3>
 
   </sect2>




More information about the blfs-book mailing list