Index: general.ent
===================================================================
--- general.ent (revision d33eabce3886e651af4311bbcd77a56a7a291739)
+++ general.ent (revision adb388a1a99ab80db417cf31fa7390958b15b55b)
@@ -491,5 +491,5 @@
-
+
Index: introduction/welcome/changelog.xml
===================================================================
--- introduction/welcome/changelog.xml (revision d33eabce3886e651af4311bbcd77a56a7a291739)
+++ introduction/welcome/changelog.xml (revision adb388a1a99ab80db417cf31fa7390958b15b55b)
@@ -46,4 +46,8 @@
+ [randy] - Updated to Thunderbird-1.5 and changed the build
+ method to use 'client.mk' and '.mozconfig'.
+
+ [randy] - Added information about using system-installed
versions of the NSS libraries and added additional configuration
Index: xsoft/other/thunderbird.xml
===================================================================
--- xsoft/other/thunderbird.xml (revision d33eabce3886e651af4311bbcd77a56a7a291739)
+++ xsoft/other/thunderbird.xml (revision adb388a1a99ab80db417cf31fa7390958b15b55b)
@@ -7,29 +7,13 @@
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
]>
-
-
@@ -83,10 +67,9 @@
- Required patch:
-
-
- Required patch:
+ Required patch (if using system-installed versions of
+ NSS and NSPR:)
+
+
@@ -94,7 +77,9 @@
To enable the Enigmail extension to the
Thunderbird mail client, you'll need to download
- the two tarballs below. The Enigmail extension
+ the tarball shown below. The Enigmail extension
allows users to access the authentication and encryption features provided
- by the GnuPG package.
+ by the GnuPG package. The Enigmail extension
+ will not operate correctly unless you have
+ installed.
@@ -103,11 +88,5 @@
- Download MD5 sum (Enigmail): &thunderbird-enigmail-md5sum;
-
-
-
-
-
- Download MD5 sum (IPC): &thunderbird-ipc-md5sum;
+ Download MD5 sum: &thunderbird-enigmail-md5sum;
@@ -116,22 +95,23 @@
Required
- ,
- and
-
-
- Recommended
- (run-time only dependency
- for the Enigmail extension)
+ ,
+ , and
+
+
+ Note: libjpeg should have been installed
+ before GTK+ and should exist on your system. If
+ for some reason you haven't installed libjpeg,
+ you should remove the option from the
+ .mozconfig file created below.
+
+ Recommended (if you will be installing any
+ other package that utilizes NSS/NSPR, such as
+ Firefox or
+ Mozilla)
+ Optional
- ,
- ,
- ,
- ,
- or
- (for the GSSAPI libraries),
- ,
- Xprint,
- Electric Fence
+ and
+ (to build the gnomevfs extension)
@@ -141,69 +121,144 @@
The configuration of Thunderbird is
- very similar to and hence the options will not
- be discussed. Refer to the instructions for
- explanations and additional configuration information.
+ accomplished by creating a .mozconfig file containing
+ the desired configuration options. A default .mozconfig
+ is created below. To see the entire list of available configuration options
+ (and an abbreviated description of each one), issue
+ ./configure --help. If you are going to use
+ system-installed versions of the NSS and
+ NSPR 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
+ (the file must be installed in the root of the source tree
+ mozilla directory, and named
+ .mozconfig). Create the file by issuing the following
+ command:
+
+cat > .mozconfig << "EOF"
+# 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;
+
+EOF
+
+ If you have system-installed Network Security Services (NSS) and
+ Netscape Portable Runtime (NSPR) libraries and you uncommented the
+ appropriate lines in the .mozconfig file to utilize
+ them, apply the following patch:
+
+patch -Np1 -i ../thunderbird-&thunderbird-version;-system_nss-1.patchCompile Thunderbird by
- running the following commands:
-
-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
-
- You should add the switch
- to the configure script if you have
- libjpeg installed.
+ issuing the following commands:
+
+sed -i "s/^ enum$/& xptinfo_enum_1/" \
+ xpcom/reflect/xptinfo/public/xptinfo.h &&
+make -f client.mk buildIf you're building the Enigmail extension,
- execute the following steps:
-
-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
+ issue the following commands:
+
+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 xpiInstall Thunderbird by running the following
commands as the root user:
-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 &&
+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 \
@@ -213,11 +268,52 @@
/usr/lib/thunderbird-&thunderbird-version;/defaults/isp/US
- If you're installing the Enigmail extension,
+ If you built Thunderbird utilizing
+ system-installed NSS and NSPR libraries, the
+ thunderbird-ns*.pcpkgconfig
+ files need to be modified. Issue the following command as the
+ root user:
+
+sed -i 's|/thunderbird-1.5||' /usr/lib/pkgconfig/thunderbird-ns*.pc
+
+ If you did NOT build
+ Thunderbird utilizing system-installed NSS and
+ NSPR libraries, issue the following commands as the
+ root user to install the NSS
+ interface headers:
+
+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
+
+ If you built the Enigmail extension,
issue the following commands as the root user:
-
-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
+ class="username">root user to install the
+ .xpi file:
+
+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
+
+ If you want to install Enigmail globally
+ so that all users who run Thunderbird will have
+ access to the extension, issue the command shown below. Note that this
+ procedure starts an instance of Thunderbird and
+ you must have an X server running. Issue the following command as the
+ root user:
+
+/usr/bin/thunderbird -install-global-extension \
+ /usr/lib/thunderbird-&thunderbird-version;/xpi_store/$ENIGMAIL_FILENAME
+
+ Global installation of other extensions can be done using the same
+ basic method as the Enigmail extension. See the
+ Configuring Thunderbird section below for information about
+ configuring Enigmail for individual users if you
+ did not not install it globally.
+
+
@@ -239,11 +337,4 @@
- Finally, unset the build variables from the unprivileged user's
- environment:
-
-unset MOZILLA_OFFICIAL &&
-unset BUILD_OFFICIAL &&
-unset MOZ_THUNDERBIRD
-
@@ -251,15 +342,29 @@
Command Explanations
- patch -Np1 -i ...: This patch fixes three major
- issues with the Thunderbird installation. First,
- it moves the installation of the prefs.js file from
- /usr/bin/defaults/profile to
- /usr/lib/thunderbird-&thunderbird-version;/defaults/profile,
- it fixes a profile locking problem if the thunderbird
- script is called when Thunderbird is already
- running and last, makes it so that if a
- mailto: URL is clicked, a message
- compose window will open with the To:
- field filled out.
+ sed -i "s/^ enum$/& xptinfo_enum_1/" ...:
+ This command is used to fix an anonymous enum in an external/public
+ interface header file.
+
+ make -f client.mk ...: Mozilla products are
+ packaged to allow the use of a configuration file which can be used to
+ pass the configuration settings to the configure
+ command. make uses the client.mk
+ file to get initial configuration and setup parameters, then depending on
+ the target parameter (build or
+ install), either runs the
+ configure script and compiles the package or installs
+ the package.
+
+ ./makemake -r: This command is used to recursively
+ create Makefiles in the current directory.
+
+ make -C ... xpi: This command builds the
+ Enigmail
+ .xpi file which is used to install
+ Enigmail.
+
+ install .../movemail.rdf .../rss.rdf ...: These
+ commands are used to install two files inadvertently left out of the
+ installation script.
@@ -270,12 +375,23 @@
Configuration Information
- Configuration of Thunderbird to use the
- Enigmail extension must be done on an
- as-needed basis for each user of the system who may use
- Thunderbird. It is accomplished through the
- ThunderbirdTools menu. Choose
- the Extensions – Install option and
- fill in the Look in: field with
- /usr/lib/thunderbird-&thunderbird-version;/extensions.
+ No specific configuration is required as long as the
+ thunderbird script is in the user's path. If
+ Thunderbird is installed in a non-standard
+ location, then make a symlink to the thunderbird
+ script in the /usr/bin
+ directory.
+
+ If you don't have privileges to install extensions globally, or
+ you prefer to not install global extensions, you can configure
+ Thunderbird on an individual user basis for
+ access to extensions. For example, if you built the
+ Enigmail 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 Thunderbird. It is
+ accomplished through the Thunderbird
+ Tools menu. Choose the Extensions –
+ Install option and fill in the Look in:
+ field with /usr/lib/thunderbird-&thunderbird-version;/xpi_store.
You'll then see the
enigmail-&thunderbird-enigmail-version;-linux-????.xpi
@@ -284,4 +400,41 @@
Enigmail extension will install and you will
be prompted to restart Thunderbird.
+
+ If your Window or Desktop Manager does not allow you to configure
+ a default browser, you can add a configuration parameter to
+ Thunderbird 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.
+
+ First, open the configuration dialog by opening the
+ Edit drop-down menu. Choose Preferences
+ and then click on the Advanced icon on the top menu
+ bar. Choose the General tab and click on the
+ Config Editor button. This will display a list of the
+ configuration preferences and information related to each one. You can
+ use the Filter: 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
+ Modify from the menu and change the value. Creating new
+ preference items is accomplished in the same way, except choose
+ New from the menu and provide the desired data into the
+ fields when prompted.
+
+ The configuration preference item you need to check so that
+ Thunderbird uses a specified browser is the
+ network.protocol-handler.app.http which should
+ be set to the path of the desired browser, e.g.,
+ .
+
+
+ There is a multitude of configuration parameters you can tweak to
+ customize Thunderbird. A very extensive and
+ up-to-date list of these parameters can be found at .
+