source: psi/trunk/Readme-OS2.txt@ 170

Psi/2 for OS/2
--------------

This file contains information specific to the OS/2 version of Psi.
Before reading it, please refer to the Readme.txt file that contains
general information about Psi.

For a list of changes, see the Changes.txt file.


Requirements
------------

1.  Make sure kLIBC 0.6.1 library (libc061.dll) is installed on your system.
    If not, download it from ftp://ftp.netlabs.org/pub/gcc/libc-0.6.1-csd1.zip
    and unzip the archive to a directory you plan to install Psi to or to one
    of the directories listed in your LIBPATH environment variable.
    
2.  (Optional) If you want to use anti-aliased fonts in Psi, download and
    install the InnoTek Font Engine for OS/2.  The direct download link is
    http://download.innotek.de/ft2lib/InnoTek_FT2LIB_260_Beta1.exe


Manual Installation
-------------------

1.  Unzip the Psi archive containing this file to a directory of your
    choice and run the Psi executable (psi.exe).
    
2.  Additionally, you can download a Language Pack for your language using
    the following link: http://psi-im.org/download.  Follow the on-site
    instructions in order to install it.

3.  If you want to use the "PM Default Browser/Mail" setting to open links
    within chat windows, make sure that you have the default PM broser and
    mail client applications set up correctly.  The easiest way to do this is
    to use the "Configure Internet Applications" tool from Hobbes
    (http://hobbes.nmsu.edu/pub/os2/apps/misc/configapps1_1_1.zip).

Please refer to the Trobuleshooting section below for additional information
on how to resolve problems you may encounter when running Psi for OS/2.


Upgrading to a New Vesion
-------------------------

If you are upgrading your installation from a previous version of Psi, please
always use a clean directory to install the new version to avoid possible file
conflicts.

Please note that installing a new version to a clean directory will not affect
your existing personal configuration data (Psi profiles, account settings,
message history) because it is stored in a separate directory and therefore
will be preserved.  It is however recommended to make a backup copy of all
configuration data before starting a new version of Psi for the first time
(to protect from accidential data loss due to possible changes in formats of
configuration files).  Refer to the section called "Configuration Data" for
more details about where this data is stored.

Note that if you want to run two different versions of Psi simultaneously
(in general, there is no such a need, but just to let you know), you will have
to create and use a .CMD script that sets the following environment variables
prior to starting the Psi executable:

    set BEGINLIBPATH=<path_to_Psi_exe>
    set LIBPATHSTRICT=T


Configuration Data
------------------

Psi stores all configuration files (such as Psi profiles, account settings,
message history, etc.) in the subdirectory /PsiData of your home directory
(pointed to by the HOME environment variable).  Note that if the HOME variable
is invalid or points to a non-existing location, the /PsiData subdirectory
will be created in the root directory of the boot drive.

The name of the last used Psi profile is stored in the Open32 Registry
under the key HKEY_CURRENT_USER\Software\Affinix\psi.

The paths and parameters to the default PM browser and mail client applications
are taken from the HINI_USER_PROFILE\WPURLDEFAULTSETTINGS registry key (stored
in the X:\OS2\OS2.INI file).


Troubleshooting
---------------

This section describes known problems you may encounter when running
Psi for OS/2, together with possible solutions.

1.  If you have a single-streamed sound card (a card that cannot play
    more than one sound at a time) and experience problems with sound
    in Psi (such as 100% CPU load when playing too many sounds
    simultaneously), try to add the following line to CONFIG.SYS
    (or to the .CMD script that starts Psi):

        SET QT_PM_NO_SOUND_SHARE=YES

    This will tell the Qt library to open sound devices in the
    exclusive mode.


Current Limitations and Known Bugs
----------------------------------

1.  PGP encryption is completely untested and probably will not work.

2.  The global hot keys are not available.

3.  Idle (i.e. Auto-Away) detection is only sensitive to mouse movements,
    meaning that Psi will go away if the mouse is not moved durng the specified
    amount of time, regardless of whether one presses something on the keyboard
    or not.  Likewise, using the keyboard will not cancel the Auto-Away state.

4.  The directory watcher service is not available (affects PGP encryption
    support).

5.  There is no "tray icon" (xCenter widget) for Psi. It will be available
    later.
    
6.  Power management events such as "sleep" or "wakeup" are not detected by Psi.

7.  Drag and Drop support in Qt/OS2 is not yet finished, so there are few
    known issues (for example, text in entry fields may be corrupted when the
    drag object is moved over them).

8.  The "Roster window always on top" option is temporarily removed from the
    options dialog because this functionality is not yet available in Qt/OS2.

9.  DBCS characters can neither be entered nor displayed correctly
    (current Qt limitation).