Changeset adb388a


Ignore:
Timestamp:
01/23/2006 11:32:52 PM (18 years ago)
Author:
Randy McMurchy <randy@…>
Branches:
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
Children:
5c09d10
Parents:
d33eabc
Message:

Updated to Thunderbird-1.5 and changed the build method to use 'client.mk' and '.mozconfig'

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

Files:
3 edited

Legend:

Unmodified
Added
Removed
  • general.ent

    rd33eabc radb388a  
    491491
    492492<!-- Chapter 36 -->
    493 <!ENTITY thunderbird-version          "1.0.6">
     493<!ENTITY thunderbird-version          "1.5">
    494494<!ENTITY pan-version                  "0.14.2">
    495495<!ENTITY balsa-version                "2.3.6">
  • introduction/welcome/changelog.xml

    rd33eabc radb388a  
    4646      <itemizedlist>
    4747        <listitem>
     48          <para>[randy] - Updated to Thunderbird-1.5 and changed the build
     49          method to use 'client.mk' and '.mozconfig'.</para>
     50        </listitem>
     51        <listitem>
    4852          <para>[randy] - Added information about using system-installed
    4953          versions of the NSS libraries and added additional configuration
  • xsoft/other/thunderbird.xml

    rd33eabc radb388a  
    77  <!ENTITY thunderbird-download-http     "http://ftp.mozilla.org/pub/mozilla.org/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;-source.tar.bz2">
    88  <!ENTITY thunderbird-download-ftp      "ftp://ftp.mozilla.org/pub/mozilla.org/thunderbird/releases/&thunderbird-version;/source/thunderbird-&thunderbird-version;-source.tar.bz2">
    9   <!ENTITY thunderbird-md5sum            "a0ddcc8bd5ee2c9be724b6963ad27111">
    10   <!ENTITY thunderbird-size              "33.3 MB">
    11   <!ENTITY thunderbird-buildsize         "560 MB">
    12   <!ENTITY thunderbird-time              "10.3 SBU">
    13 
    14   <!ENTITY thunderbird-enigmail-version  "0.92.0">
    15   <!ENTITY thunderbird-enigmail-download "http://downloads.mozdev.org/enigmail/src/enigmail-&thunderbird-enigmail-version;.tar.gz">
    16   <!ENTITY thunderbird-enigmail-md5sum   "50c369ce6d6fcb2d275cd30319a601ff">
    17 
    18   <!ENTITY thunderbird-ipc-version       "1.1.3">
    19   <!ENTITY thunderbird-ipc-download      "http://downloads.mozdev.org/enigmail/src/ipc-&thunderbird-ipc-version;.tar.gz">
    20   <!ENTITY thunderbird-ipc-md5sum        "64ba4c6e3b52568468c4f6680ec7e679">
     9  <!ENTITY thunderbird-md5sum            "781c1cd1a01583d9b666d8c2fe4288e6">
     10  <!ENTITY thunderbird-size              "35.0 MB">
     11  <!ENTITY thunderbird-buildsize         "597 MB">
     12  <!ENTITY thunderbird-time              "18.1 SBU">
     13
     14  <!ENTITY thunderbird-enigmail-version  "0.94.0">
     15  <!ENTITY thunderbird-enigmail-download "http://www.mozilla-enigmail.org/downloads/src/enigmail-&thunderbird-enigmail-version;.tar.gz">
     16  <!ENTITY thunderbird-enigmail-md5sum   "d326c302c1d2d68217fffcaa01ca7632">
    2117]>
    22 
    23 <!--
    24 
    25 Devs:
    26 
    27 Always check the mail/config/mozconfig file in the source tree for
    28 any changes to the options passed to configure. This file shows the
    29 default build used by Mozilla. BLFS adds to this, but the values here
    30 should be in our setup. The stuff about ActiveX can be ignored as
    31 that is Windows crap only.
    32 
    33 -->
    3418
    3519<sect1 id="thunderbird" xreflabel="Thunderbird-&thunderbird-version;">
     
    8367    <itemizedlist spacing="compact">
    8468      <listitem>
    85         <para>Required patch: <ulink
    86         url="&patch-root;/thunderbird-&thunderbird-version;-gcc4-2.patch"/></para>
    87       </listitem>
    88       <listitem>
    89         <para>Required patch: <ulink
    90         url="&patch-root;/thunderbird-&thunderbird-version;-fixes-1.patch"/></para>
     69        <para>Required patch (if using system-installed versions of
     70        <application>NSS</application> and <application>NSPR</application>:)
     71        <ulink
     72        url="&patch-root;/thunderbird-&thunderbird-version;-system_nss-1.patch"/>
     73        </para>
    9174      </listitem>
    9275    </itemizedlist>
     
    9477    <para>To enable the <application>Enigmail</application> extension to the
    9578    <application>Thunderbird</application> mail client, you'll need to download
    96     the two tarballs below. The <application>Enigmail</application> extension
     79    the tarball shown below. The <application>Enigmail</application> extension
    9780    allows users to access the authentication and encryption features provided
    98     by the <application>GnuPG</application> package.</para>
     81    by the <application>GnuPG</application> package. The Enigmail extension
     82    will not operate correctly unless you have <xref linkend="gnupg"/>
     83    installed.</para>
    9984
    10085    <itemizedlist spacing='compact'>
     
    10388      </listitem>
    10489      <listitem>
    105         <para>Download MD5 sum (Enigmail): &thunderbird-enigmail-md5sum;</para>
    106       </listitem>
    107       <listitem>
    108         <para><ulink url="&thunderbird-ipc-download;"/></para>
    109       </listitem>
    110       <listitem>
    111         <para>Download MD5 sum (IPC): &thunderbird-ipc-md5sum;</para>
     90        <para>Download MD5 sum: &thunderbird-enigmail-md5sum;</para>
    11291      </listitem>
    11392    </itemizedlist>
     
    11695
    11796    <bridgehead renderas="sect4">Required</bridgehead>
    118     <para role="required"><xref linkend="zip"/>,
    119     <xref linkend="gtk2"/> and
    120     <xref linkend="libidl"/></para>
    121 
    122     <bridgehead renderas="sect4">Recommended</bridgehead>
    123     <para role="recommended"><xref linkend="gnupg"/> (run-time only dependency
    124     for the <application>Enigmail</application> extension)</para>
     97    <para role="required"><xref linkend="gtk2"/>,
     98    <xref linkend="libidl"/>, and
     99    <xref linkend="zip"/></para>
     100
     101    <para>Note: <application>libjpeg</application> should have been installed
     102    before <application>GTK+</application> and should exist on your system. If
     103    for some reason you haven't installed <application>libjpeg</application>,
     104    you should remove the <option>--with-system-jpeg</option> option from the
     105    <filename>.mozconfig</filename> file created below.</para>
     106
     107    <bridgehead renderas="sect4">Recommended (if you will be installing any
     108    other package that utilizes NSS/NSPR, such as
     109    <application>Firefox</application> or
     110    <application>Mozilla</application>)</bridgehead>
     111    <para role="recommended"><xref linkend="nss"/></para>
    125112
    126113    <bridgehead renderas="sect4">Optional</bridgehead>
    127     <para role="optional"><xref linkend="libjpeg"/>,
    128     <xref linkend="unzip"/>,
    129     <xref linkend="gnome-vfs"/>,
    130     <xref linkend="libgnome"/>,
    131     <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>
    132     (for the GSSAPI libraries),
    133     <xref linkend="doxygen"/>,
    134     <ulink url="http://xprint.mozdev.org/">Xprint</ulink>,
    135     <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink></para>
     114    <para role="optional"><xref linkend="unzip"/> and
     115    <xref linkend="libgnomeui"/> (to build the gnomevfs extension)</para>
    136116
    137117  </sect2>
     
    141121
    142122    <para>The configuration of <application>Thunderbird</application> is
    143     very similar to <xref linkend="mozilla"/> and hence the options will not
    144     be discussed. Refer to the <xref linkend="mozilla"/> instructions for
    145     explanations and additional configuration information.</para>
     123    accomplished by creating a <filename>.mozconfig</filename> file containing
     124    the desired configuration options. A default <filename>.mozconfig</filename>
     125    is created below. To see the entire list of available configuration options
     126    (and an abbreviated description of each one), issue
     127    <command>./configure --help</command>. If you are going to use
     128    system-installed versions of the <application>NSS</application> and
     129    <application>NSPR</application> libraries, ensure you uncomment the two
     130    lines near the bottom of the file. You may also wish to review the entire
     131    file and uncomment any other desired options. If you would prefer to
     132    download the file instead of creating it by typing or cut-and-pasting, you
     133    can find it at <ulink
     134    url="http://anduin.linuxfromscratch.org/files/BLFS/thunderbird-&thunderbird-version;-mozconfig"/>
     135    (the file must be installed in the root of the source tree
     136    <filename class='directory'>mozilla</filename> directory, and named
     137    <filename>.mozconfig</filename>). Create the file by issuing the following
     138    command:</para>
     139
     140<screen><userinput>cat &gt; .mozconfig &lt;&lt; "EOF"
     141<literal># This file contains the options used in the Thunderbird build. You may
     142# need to specify additional options for your specific build needs.
     143# Use the information provided by running './configure --help' to
     144# help you determine if you need to add any additional options.
     145# Some additional options can be added by uncommenting the examples
     146# in this file or adding options by inserting a line containing
     147# 'ac_add_options --some-option-you-need'.
     148
     149
     150# Use the default settings specified in the source tree
     151. $topsrcdir/mail/config/mozconfig
     152
     153# Create an object directory and specify to build the package in that
     154# directory. If desired, modify the location of the object directory
     155# to a directory inside the source tree by removing '../' from the
     156# line below.
     157mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/../thunderbird-build
     158
     159# Specify the installation prefix. If you would prefer Thunderbird
     160# installed in a different prefix, modify the line below to fit
     161# your needs. You'll also need to modify some of the instructions in
     162# the BLFS book to point to your desired prefix.
     163ac_add_options --prefix=/usr
     164
     165# These options are used so that the Thunderbird binaries are linked to
     166# the system-installed copies of the specified libraries instead of
     167# the source tree code which may not be the most recent versions.
     168ac_add_options --with-system-zlib
     169ac_add_options --with-system-png
     170ac_add_options --with-system-jpeg
     171ac_add_options --enable-system-cairo
     172
     173# This option causes the installed binaries to have the official
     174# Thunderbird name embedded in them. Due to license restrictions, you
     175# may not distribute binaries created using this option.
     176ac_add_options --enable-official-branding
     177
     178# This option specifies to include support for rendering the HTML
     179# &lt;canvas&gt;&lt;/canvas&gt; tag in the Thunderbird mail client.
     180#ac_add_options --enable-canvas
     181
     182# This option is used so that the debugging symbols are removed from
     183# the installed binaries during the installation process. Comment out
     184# this option if you may have a need to retain the debugging symbols
     185# in the installed binaries. Note that this can substantially
     186# increase the size of the installed binaries.
     187ac_add_options --enable-strip
     188
     189# This option is added so that test libraries and programs are not
     190# built. These would only be required for debugging purposes.
     191ac_add_options --disable-tests
     192
     193# This option is added so that the Mozilla Installer program is not
     194# built or installed. The program is not required for a BLFS
     195# installation of Thunderbird.
     196ac_add_options --disable-installer
     197
     198# This option is used to disable the a11y support in the Thunderbird
     199# binaries. Comment out this option if you require a11y support.
     200ac_add_options --disable-accessibility
     201
     202# This option is used to enable source tree included LDAP support in
     203# the Thunderbird binaries.
     204ac_add_options --enable-ldap
     205
     206# This option is used to enable support for rendering SVG files in the
     207# Thunderbird mail client. Uncomment the line below to enable the option.
     208#ac_add_options --enable-svg
     209
     210# Uncomment this option if you desire support for dual-monitor
     211# display of Thunderbird using the X-Window Xinerama libraries.
     212#ac_add_options --enable-xinerama
     213
     214# These two options enable support for building Thunderbird with
     215# system-installed versions of the Network Security Services (NSS)
     216# and Netscape Portable Runtime (NSPR) libraries. Uncomment both
     217# lines to enable support for system-installed NSS/NSPR.
     218#ac_add_options --with-system-nss
     219#ac_add_options --with-system-nspr
     220
     221# This option identifies the default binary directory of the Thunderbird
     222# installation and is used to locate Thunderbird's installed files. This
     223# option is not required for end-user use, and is only used for
     224# development purposes.
     225#ac_add_options --with-default-mozilla-five-home=/usr/lib/thunderbird-&thunderbird-version;</literal>
     226
     227EOF</userinput></screen>
     228
     229    <para>If you have system-installed Network Security Services (NSS) and
     230    Netscape Portable Runtime (NSPR) libraries and you uncommented the
     231    appropriate lines in the <filename>.mozconfig</filename> file to utilize
     232    them, apply the following patch:</para>
     233
     234<screen><userinput>patch -Np1 -i ../thunderbird-&thunderbird-version;-system_nss-1.patch</userinput></screen>
    146235
    147236    <para>Compile <application>Thunderbird</application> by
    148     running the following commands:</para>
    149 
    150 <screen><userinput>export MOZILLA_OFFICIAL="1" &amp;&amp;
    151 export BUILD_OFFICIAL="1" &amp;&amp;
    152 export MOZ_THUNDERBIRD="1" &amp;&amp;
    153 patch -Np1 -i ../thunderbird-&thunderbird-version;-gcc4-2.patch &amp;&amp;
    154 patch -Np1 -i ../thunderbird-&thunderbird-version;-fixes-1.patch &amp;&amp;
    155 ./configure --prefix=/usr \
    156             --with-default-mozilla-five-home=/usr/lib/thunderbird-&thunderbird-version; \
    157             --with-user-appdir=.thunderbird \
    158             --with-system-zlib \
    159             --with-system-png \
    160             --enable-application=mail \
    161             --enable-default-toolkit=gtk2 \
    162             --enable-extensions=wallet,spellcheck,xmlextras,webservices \
    163             --enable-crypto \
    164             --enable-xft \
    165             --enable-xinerama \
    166             --enable-optimize \
    167             --enable-reorder \
    168             --enable-strip \
    169             --enable-cpp-rtti \
    170             --enable-single-profile \
    171             --enable-necko-protocols=http,file,jar,viewsource,res,data \
    172             --enable-image-decoders=default,-xbm \
    173             --disable-freetype2 \
    174             --disable-accessibility \
    175             --disable-debug \
    176             --disable-tests \
    177             --disable-logging \
    178             --disable-pedantic \
    179             --disable-installer \
    180             --disable-profilesharing \
    181             --disable-mathml \
    182             --disable-oji \
    183             --disable-plugins \
    184             --disable-necko-disk-cache &amp;&amp;
    185 make</userinput></screen>
    186 
    187     <para>You should add the <option>--with-system-jpeg</option> switch
    188     to the <command>configure</command> script if you have
    189     <application>libjpeg</application> installed.</para>
     237    issuing the following commands:</para>
     238
     239<screen><userinput>sed -i "s/^    enum$/&amp; xptinfo_enum_1/" \
     240    xpcom/reflect/xptinfo/public/xptinfo.h &amp;&amp;
     241make -f client.mk build</userinput></screen>
    190242
    191243    <para>If you're building the <application>Enigmail</application> extension,
    192     execute the following steps:</para>
    193 
    194 <screen><userinput>tar -xf ../enigmail-&thunderbird-enigmail-version;.tar.gz -C extensions &amp;&amp;
    195 tar -xf ../ipc-&thunderbird-ipc-version;.tar.gz -C extensions &amp;&amp;
    196 build/autoconf/make-makefile extensions/ipc extensions/enigmail &amp;&amp;
    197 make -C extensions/ipc &amp;&amp;
    198 make -C extensions/enigmail &amp;&amp;
    199 make -C extensions/enigmail xpi</userinput></screen>
     244    issue the following commands:</para>
     245
     246<screen><userinput>tar -xf ../enigmail-&thunderbird-enigmail-version;.tar.gz -C mailnews/extensions &amp;&amp;
     247cd mailnews/extensions/enigmail &amp;&amp;
     248
     249./makemake -r &amp;&amp;
     250cd ../../.. &amp;&amp;
     251
     252make -C ../thunderbird-build/mailnews/extensions/enigmail &amp;&amp;
     253make -C ../thunderbird-build/mailnews/extensions/enigmail xpi</userinput></screen>
    200254
    201255    <para>Install <application>Thunderbird</application> by running the following
    202256    commands as the <systemitem class="username">root</systemitem> user:</para>
    203257
    204 <screen role="root"><userinput>make install &amp;&amp;
    205 install -v -m755 -d /usr/include/thunderbird-&thunderbird-version;/nss &amp;&amp;
    206 cp -v -Lf dist/private/nss/*.h dist/public/nss/*.h \
    207     /usr/include/thunderbird-&thunderbird-version;/nss &amp;&amp;
     258<screen role="root"><userinput>make -f client.mk install &amp;&amp;
     259
     260install -v -m644 ../thunderbird-build/dist/public/ldap-private/* \
     261    /usr/include/thunderbird-1.5/ldap &amp;&amp;
     262
    208263install -v -m755 -d /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/US &amp;&amp;
    209264install -v -m644 mailnews/base/ispdata/movemail.rdf \
     
    213268    /usr/lib/thunderbird-&thunderbird-version;/defaults/isp/US</userinput></screen>
    214269
    215     <para>If you're installing the <application>Enigmail</application> extension,
     270    <para>If you built <application>Thunderbird</application> utilizing
     271    system-installed NSS and NSPR libraries, the
     272    <filename>thunderbird-ns*.pc</filename> <application>pkgconfig</application>
     273    files need to be modified. Issue the following command as the
     274    <systemitem class="username">root</systemitem> user:</para>
     275
     276<screen role="root"><userinput>sed -i 's|/thunderbird-1.5||' /usr/lib/pkgconfig/thunderbird-ns*.pc</userinput></screen>
     277
     278    <para>If you did <emphasis role="strong">NOT</emphasis> build
     279    <application>Thunderbird</application> utilizing system-installed NSS and
     280    NSPR libraries, issue the following commands as the
     281    <systemitem class="username">root</systemitem> user to install the NSS
     282    interface headers:</para>
     283
     284<screen role="root"><userinput>install -v -m755 -d /usr/include/thunderbird-&thunderbird-version;/nss &amp;&amp;
     285cp -v -Lf ../thunderbird-build/dist/{private,public}/nss/*.h \
     286    /usr/include/thunderbird-&thunderbird-version;/nss</userinput></screen>
     287
     288    <para>If you built the <application>Enigmail</application> extension,
    216289    issue the following commands as the <systemitem
    217     class="username">root</systemitem> user:</para>
    218 
    219 <screen role="root"><userinput>install -v -m755 -d /usr/lib/thunderbird-&thunderbird-version;/extensions &amp;&amp;
    220 install -v -m644 dist/bin/enigmail-&thunderbird-enigmail-version;-linux-*.xpi \
    221     /usr/lib/thunderbird-&thunderbird-version;/extensions</userinput></screen>
     290    class="username">root</systemitem> user to install the
     291    <filename>.xpi</filename> file:</para>
     292
     293<screen role="root"><userinput>ENIGMAIL_FILENAME=$(basename \
     294    `ls ../thunderbird-build/dist/bin/enigmail-&thunderbird-enigmail-version;-*.xpi`) &amp;&amp;
     295
     296install -v -m644 -D ../thunderbird-build/dist/bin/$ENIGMAIL_FILENAME \
     297    usr/lib/thunderbird-1.5/xpi_store/$ENIGMAIL_FILENAME</userinput></screen>
     298
     299    <para>If you want to install <application>Enigmail</application> globally
     300    so that all users who run <application>Thunderbird</application> will have
     301    access to the extension, issue the command shown below. Note that this
     302    procedure starts an instance of <application>Thunderbird</application> and
     303    you must have an X server running. Issue the following command as the
     304    <systemitem class="username">root</systemitem> user:</para>
     305
     306<screen role="root"><userinput>/usr/bin/thunderbird -install-global-extension \
     307    /usr/lib/thunderbird-&thunderbird-version;/xpi_store/$ENIGMAIL_FILENAME</userinput></screen>
     308
     309    <para>Global installation of other extensions can be done using the same
     310    basic method as the <application>Enigmail</application> extension. See the
     311    <quote>Configuring Thunderbird</quote> section below for information about
     312    configuring <application>Enigmail</application> for individual users if you
     313    did not not install it globally.</para>
     314
     315    <!-- This appears to not be required any longer. The regchrome program
     316         is not built any longer, and multi-user access to Thunderbird appears
     317         to work fine without running regxpcom and touching the files. -Randy
    222318
    223319    <para>To enable multi-user operation, execute the following as the
     
    230326./regchrome &amp;&amp;
    231327touch `find . -name *.rdf`</userinput></screen>
     328
     329    -->
    232330
    233331    <note>
     
    239337    </note>
    240338
    241     <para>Finally, unset the build variables from the unprivileged user's
    242     environment:</para>
    243 
    244 <screen><userinput>unset MOZILLA_OFFICIAL &amp;&amp;
    245 unset BUILD_OFFICIAL &amp;&amp;
    246 unset MOZ_THUNDERBIRD</userinput></screen>
    247 
    248339  </sect2>
    249340
     
    251342    <title>Command Explanations</title>
    252343
    253     <para><command>patch -Np1 -i ...</command>: This patch fixes three major
    254     issues with the <application>Thunderbird</application> installation. First,
    255     it moves the installation of the <filename>prefs.js</filename> file from
    256     <filename class='directory'>/usr/bin/defaults/profile</filename> to
    257     <filename class='directory'>/usr/lib/thunderbird-&thunderbird-version;/defaults/profile</filename>,
    258     it fixes a profile locking problem if the <command>thunderbird</command>
    259     script is called when <application>Thunderbird</application> is already
    260     running and last, makes it so that if a
    261     <computeroutput>mailto:</computeroutput> URL is clicked, a message
    262     compose window will open with the <computeroutput>To:</computeroutput>
    263     field filled out.</para>
     344    <para><command>sed -i "s/^    enum$/&amp; xptinfo_enum_1/" ...</command>:
     345    This command is used to fix an anonymous enum in an external/public
     346    interface header file.</para>
     347
     348    <para><command>make -f client.mk ...</command>: Mozilla products are
     349    packaged to allow the use of a configuration file which can be used to
     350    pass the configuration settings to the <command>configure</command>
     351    command. <command>make</command> uses the <filename>client.mk</filename>
     352    file to get initial configuration and setup parameters, then depending on
     353    the target parameter (<parameter>build</parameter> or
     354    <parameter>install</parameter>), either runs the
     355    <command>configure</command> script and compiles the package or installs
     356    the package.</para>
     357
     358    <para><command>./makemake -r</command>: This command is used to recursively
     359    create <filename>Makefile</filename>s in the current directory.</para>
     360
     361    <para><command>make -C ... xpi</command>: This command builds the
     362    <application>Enigmail</application>
     363    <filename class='extension'>.xpi</filename> file which is used to install
     364    <application>Enigmail</application>.</para>
     365
     366    <para><command>install .../movemail.rdf .../rss.rdf ...</command>: These
     367    commands are used to install two files inadvertently left out of the
     368    installation script.</para>
    264369
    265370  </sect2>
     
    270375    <sect3><title>Configuration Information</title>
    271376
    272       <para>Configuration of <application>Thunderbird</application> to use the
    273       <application>Enigmail</application> extension must be done on an
    274       as-needed basis for each user of the system who may use
    275       <application>Thunderbird</application>. It is accomplished through the
    276       <application>Thunderbird</application> <quote>Tools</quote> menu. Choose
    277       the <quote>Extensions</quote> &ndash; <quote>Install</quote> option and
    278       fill in the <quote>Look in:</quote> field with
    279       <filename class='directory'>/usr/lib/thunderbird-&thunderbird-version;/extensions</filename>.
     377      <para>No specific configuration is required as long as the
     378      <command>thunderbird</command> script is in the user's path. If
     379      <application>Thunderbird</application> is installed in a non-standard
     380      location, then make a symlink to the <command>thunderbird</command>
     381      script in the <filename class="directory">/usr/bin</filename>
     382      directory.</para>
     383
     384      <para>If you don't have privileges to install extensions globally, or
     385      you prefer to not install global extensions, you can configure
     386      <application>Thunderbird</application> on an individual user basis for
     387      access to extensions. For example, if you built the
     388      <application>Enigmail</application> extension and did not install it
     389      globally, it can be installed on an as-needed basis for each user of the
     390      system who may use <application>Thunderbird</application>. It is
     391      accomplished through the <application>Thunderbird</application>
     392      <quote>Tools</quote> menu. Choose the <quote>Extensions</quote> &ndash;
     393      <quote>Install</quote> option and fill in the <quote>Look in:</quote>
     394      field with <filename
     395      class='directory'>/usr/lib/thunderbird-&thunderbird-version;/xpi_store</filename>.
    280396      You'll then see the
    281397      <filename>enigmail-&thunderbird-enigmail-version;-linux-????.xpi</filename>
     
    284400      <application>Enigmail</application> extension will install and you will
    285401      be prompted to restart <application>Thunderbird</application>.</para>
     402
     403      <para>If your Window or Desktop Manager does not allow you to configure
     404      a default browser, you can add a configuration parameter to
     405      <application>Thunderbird</application> so that a browser will start when
     406      when you click on an Internet/intranet/local URL. The procedure to check
     407      or modify any of the configuration parameters is quite simple and the
     408      instructions here can be used to view or modify any of the
     409      parameters.</para>
     410
     411      <para>First, open the configuration dialog by opening the
     412      <quote>Edit</quote> drop-down menu. Choose <quote>Preferences</quote>
     413      and then click on the <quote>Advanced</quote> icon on the top menu
     414      bar. Choose the <quote>General</quote> tab and click on the
     415      <quote>Config Editor</quote> button. This will display a list of the
     416      configuration preferences and information related to each one. You can
     417      use the <quote>Filter:</quote> bar to enter search criteria and narrow
     418      down the listed items. Changing a preference can be done using two
     419      methods. One, if the preference has a boolean value (True/False), simply
     420      double-click on the preference to toggle the value and two, for other
     421      preferences simply right-click on the desired line, choose
     422      <quote>Modify</quote> from the menu and change the value. Creating new
     423      preference items is accomplished in the same way, except choose
     424      <quote>New</quote> from the menu and provide the desired data into the
     425      fields when prompted.</para>
     426
     427      <para>The configuration preference item you need to check so that
     428      <application>Thunderbird</application> uses a specified browser is the
     429      <parameter>network.protocol-handler.app.http</parameter> which should
     430      be set to the path of the desired browser, e.g.,
     431      <option>/usr/bin/firefox</option>.</para>
     432
     433    <tip>
     434      <para>There is a multitude of configuration parameters you can tweak to
     435      customize <application>Thunderbird</application>. A very extensive and
     436      up-to-date list of these parameters can be found at <ulink
     437      url="http://preferential.mozdev.org/preferences.html"/>.</para>
     438    </tip>
    286439
    287440    </sect3>
Note: See TracChangeset for help on using the changeset viewer.