   PmW-Tb 1.5.0.5 release notes
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This is not an official release of Thunderbird, I therefore renamed the
displayed application name to PmW-Tb. Although it uses code from the 
MOZILLA_1_8_0_BRANCH checked out on 23Jul2006 for the largest part, I made
several changes:

Extra Features:
  - Add support for WPS objects in the browser, using Rich Walsh's RWS
    <https://bugzilla.mozilla.org/show_bug.cgi?id=305061>
    and ship RWS libraries and script to support it.
  - Tag downloaded files with source URL in extended attributes, using Rich
    Walsh's patch
    <https://bugzilla.mozilla.org/show_bug.cgi?id=301367>
  - Make LDAP based autocomplete work better, patch from
    <https://bugzilla.mozilla.org/show_bug.cgi?id=317566>
  - Fix the way keycodes are reported to JavaScript
    <https://bugzilla.mozilla.org/show_bug.cgi?id=222509>
  - Make menus, toolbar, and popups a bit more OS/2-like, adapting the patches
    from
    <https://bugzilla.mozilla.org/show_bug.cgi?id=314843>
    <https://bugzilla.mozilla.org/show_bug.cgi?id=336997>
  - Hopefully fix shutdown problem when SETI@Home etc. is running
    <https://bugzilla.mozilla.org/show_bug.cgi?id=346376>

Small optimizations:
  - Run the files through lxLite
    <https://bugzilla.mozilla.org/show_bug.cgi?id=296138>
  - Link all .xpt files into one (components\mail.xpt; no bug)

"Branding" issues:
  - Rename to PmW-Tb in configure.in
  - correct name in mail/locales/en-US/chrome/branding/brand.*
  - (I specifically did not change the executable name from thunderbird.exe
    because that would create problems for configurations that expect a
    thunderbird.exe.)

Other changes listed in previous versions are not necessary any more, as they
are now either part of the official Mozilla sources or superseded by a new
change.

Please report bugs to me via mozilla.dev.ports.os2 newsgroup first or email
before you blame Mozilla.org/SeaMonkey Council, or open bugs in bugzilla. ;-)

Peter Weilbacher <mozilla@Weilbacher.org>, 29Jul2006


================================================================================

= = = = = = = = = = = = =   Thunderbird Read Me    = = = = = = = = = = = = = = =

================================================================================

Thunderbird is subject to the terms detailed in the license agreement
accompanying it.

This Read Me file contains information about system requirements and
installation instructions for the OS/2 build of Thunderbird.

For more info on Thunderbird, see http://www.mozilla.org/products/thunderbird/.
For more info on the OS/2 port see http://www.mozilla.org/ports/os2. To submit
bugs or other feedback check out Bugzilla at https://bugzilla.mozilla.org for
links to known bugs, bug-writing guidelines, and more. You can also get help
with Bugzilla by pointing your IRC client to #mozillazine at irc.mozilla.org,
OS/2 specific problems are discussed in #warpzilla and in the newsgroup
mozilla.dev.ports.os2 on news.mozilla.org.


================================================================================

                          Getting Thunderbird

================================================================================

Official Milestone builds of Thunderbird are published on the release page at

  http://www.mozilla.org/products/thunderbird/releases/

OS/2 releases are not created by Mozilla.org staff and may appear on the page
http://www.mozilla.org/ports/os2 before the releases page. Be sure to read the
Thunderbird release notes linked on the releases page for information on known 
problems and installation issues with Thunderbird.


================================================================================

                        System Requirements on OS/2

================================================================================

- This release requires updated C runtime DLLs (libc-0.5.1) from
     http://www.innotek.de/products/gccos2/download/gccos2download_e.html
  in order to run. By default the installation routine places them in \OS2\DLL
  on your bootdrive, but you can put them in the same directory as Thunderbird's
  executable, or somewhere else in your LIBPATH.

- Minimum hardware requirements
  + Pentium class processor
  + 64 MiB RAM plus 64 MiB free swap space
  + 35 MiB free harddisk space for installation
    plus storage space for disk cache

- Recommended hardware for acceptable performance
  + 500 MHz processor
  + 256 MiB RAM plus 64 MiB free swap space
    NOTE: Thunderbird's performance and stability increases the more physical
    RAM is available. Especially for long sessions 512 MiB of memory is
    recommended.
  + Graphics card and driver capable of displaying more than 256 colors

- Software requirements
  + Installation on a file system supporting long file names
    (i.e. HPFS or JFS but not FAT)
  + OS/2 Warp 4 with Fixpack 15 or later
  + MPTS version 5.3
  + TCP/IP version 4.1
  + INETVER: SOCKETS.SYS=5.3007, AFOS2.SYS=5.3001, AFINET.SYS=5.3006
    NOTE: Do not attempt to use MPTS & TCP/IP versions below these INETVER
    levels. Although Thunderbird may seem to start and run normally with older
    stacks, some features Thunderbird needs are not implemented correctly in
    older MPTS versions, which may result in crashes and data loss.

  + Convenience Pack 2 or eComStation 1.0 or later meet these requirements
    out of the box.


================================================================================

                          Installation Instructions

================================================================================

For all platforms, unpack into a clean (new) directory.  Installing on top of
previously released builds may cause problems with Thunderbird.

Note: These instructions do not tell you how to build Thunderbird.
For info on building the Thunderbird source, see

  http://www.mozilla.org/build/


OS/2 Installation Instructions
------------------------------

   On OS/2, Thunderbird does not have an installation program. To install it,
   download the .zip file and follow these steps:

     1. Click the "Zip" link on the site you're downloading Thunderbird from
     to download the ZIP package to your machine. This file is typically called
     thunderbird-*-os2.zip where the "*" is replaced by the Thunderbird version.

     2. Navigate to where you downloaded the file and unpack it using your
     favorite unzip tool.

     3. Keep in mind that the unzip process creates a directory "thunderbird"
     below the location you point it to, i.e. 
        unzip thunderbird-1.0-os2.zip -d c:\thunderbird-1.0
     will unpack Thunderbird into c:\thunderbird-1.0\thunderbird.

     4. Make sure that you are _not_ unpacking over an old installation. This is
     known to cause problems.

     5. To start Thunderbird, navigate to the directory you extracted
     Thunderbird to, make sure that the C library DLLs are copied to the
     installation directory or installed in the LIBPATH, and then double-click
     the Thunderbird.exe object.


Running multiple versions concurrently
--------------------------------------

Because various members of the Mozilla family (i.e. Mozilla, Firefox, 
Thunderbird, IBM Web Browser) may use different, incompatible versions of the
same DLL, some extra steps may be required to run them concurrently.

One workaround is the LIBPATHSTRICT variable. To run Thunderbird one can create
a CMD script like the following example (where an installation of Thunderbird
exists in the directory d:\internet\thunderbird is assumed):

   set LIBPATHSTRICT=T
   rem The next line may be needed when a different Mozilla program is listed in LIBPATH
   rem set BEGINLIBPATH=d:\internet\thunderbird
   rem The next line is only needed to run two different versions of Thunderbird
   rem set MOZ_NO_REMOTE=1
   d:
   cd d:\internet\thunderbird
   thunderbird.exe %1 %2 %3 %4 %5 %6 %7 %8 %9

Similarly, one can create a program object to start Thunderbird using the
following settings:

   Path and file name: *
   Parameters:         /c set LIBPATHSTRICT=T & .\thunderbird.exe "%*"
   Working directory:  d:\internet\thunderbird

(One might need to add MOZ_NO_REMOTE and/or BEGINLIBPATH as in the CMD script
above depending on the system configuration.)

Finally, the simplest method is to use the Run! utility by Rich Walsh that can
be found in the Hobbes Software Archive:

   http://hobbes.nmsu.edu/cgi-bin/h-search?key=Run!

Read its documentation for more information.


Separating profiles from installation directory
-----------------------------------------------

To separate the locations of the user profile(s) (containing the bookmarks and
all customizations) from the installation directory to keep your preferences in
the case of an update even when using ZIP packages, set the variable 
MOZILLA_HOME to a directory of your choice. You can do this either in Config.sys
or in a script or using a program object as listed above. If you add

   set MOZILLA_HOME=f:\Data

the Thunderbird user profile will be created in "f:\Data\Thunderbird".

If you are migrating from Mozilla, Thunderbird's import routine will only find
the existing Mozilla profile data if MOZILLA_HOME is correctly set to point to
it.


Other important environment variables
-------------------------------------

There are a few enviroment variables that can be used to control special
behavior of Thunderbird on OS/2:

- set NSPR_OS2_NO_HIRES_TIMER=1
  This causes Thunderbird not to use OS/2's high resolution timer. Set this if
  other applications using the high resolution timer (multimedia apps) act
  strangely.

- set MOZILLA_USE_EXTENDED_FT2LIB=T
  If you have the Innotek Font Engine installed this variable enables special
  functions in Thunderbird to handle unicode characters.

- set MOZ_NO_REMOTE=1
  Use this to run two instances of Thunderbird simultaneously (like e.g. debug
  and optimized version).

Find more information on this topic and other tips on
   http://www.os2bbs.com/os2news/Warpzilla.html


Known Problems of the OS/2 version
----------------------------------

Cross-platform problems are usually listed in the release notes of each
milestone release.

- Bug 167884, "100% CPU load when viewing site [tiling transparent PNG]":
  https://bugzilla.mozilla.org/show_bug.cgi?id=167884
On OS/2, Mozilla's rendering engine is known to have very slow performance on
websites that use small, repeated images with transparency for their layout.
This might also affect HTML emails displayed in Thunderbird.

Other known problems can be found by following the link "Current Open Warpzilla
Bugs" on the OS/2 Mozilla page <http://www.mozilla.org/ports/os2/>.
