Changeset 73


Ignore:
Timestamp:
Sep 25, 2006, 12:07:36 AM (19 years ago)
Author:
dmik
Message:

Psi: Created new readme files (changes are now stored in the separate file); old readme is updated for Beta 2.

Location:
psi/trunk
Files:
2 added
1 edited

Legend:

Unmodified
Added
Removed

  • psi/trunk/Readme-OS2.txt

    r37 r73  
    1 Psi 0.10-os2-b1 (Beta 1)
    2 ------------------------
    3 Date: August 18th, 2006
     1Psi for OS/2
     2------------
     3
     4This file contains information specific to the OS/2 version of Psi.
     5Before reading it, please refer to the Readme.txt file that contains
     6general information about Psi.
     7
     8For a list of changes, see the Changes.txt file.
    49
    510
    6 OS/2 Port Creator/Maintainer:
    7     Dmitry A. Kuminov
    8     dmik-qt(at)hugaida.com
    9     http://svn.netlabs.org/qt3/ticket/25
     11Requirements
     12------------
    1013
    11 Using Qt Toolkit Version 3 for OS/2:
    12     Copyright (C) 1992-2000 Trolltech AS.  All rights reserved.
    13     Copyright (C) 2004 Norman ASA.  Initial OS/2 Port.
    14     Copyright (C) 2005-2006 netlabs.org.  Further OS/2 Development.
    15     Ported to OS/2 by Dmitry A. Kuminov
    16     http://svn.netlabs.org/qt3
    17 
    18 
    19 This readme contains information specific to the OS/2 version of Psi.
    20 For general information, please refer to Readme.txt, Install.txt and
    21 to the online documentation you can find at http://psi-im.org/.
    22 
    23 For the list of changes, see the bottom of this file.
     141.  Make sure kLIBC 0.6.1 library (libc061.dll) is installed on your system.
     15    If not, download it from ftp://ftp.netlabs.org/pub/gcc/libc-0.6.1-csd1.zip
     16    and unzip the archive to a directory you plan to install Psi to or to one
     17    of the directories listed in your LIBPATH environment variable.
     18   
     192.  (Optional) If you want to use anti-aliased fonts in Psi, download and
     20    install the InnoTek Font Engine for OS/2.  The direct download link is
     21    http://download.innotek.de/ft2lib/InnoTek_FT2LIB_260_Beta1.exe
    2422
    2523
    … …  
    2725-------------------
    2826
    29 1.  Make sure Innotek (Bird) LIBC 0.6.1 library (libc061.dll) is
    30     installed on your system. Download the library from
    31     ftp://ftp.netlabs.org/pub/gcc/libc-0.6.1-csd1.zip and unzip
    32     the archive to the directory you plan to install Psi to or to
    33     one of the directories listed in your LIBPATH environment variable.
     271.  Unzip the Psi archive containing this file to a directory of your
     28    choice and run the Psi executable (psi.exe).
     29   
     302.  Additionally, you can download a Language Pack for your language using
     31    the following link: http://psi-im.org/download.  Follow the on-site
     32    instructions in order to install it.
    3433
    35 2.  Unzip the Psi archive containing this file to the directory of your
    36     choice and run the Psi executable (psi.exe). No additional
    37     installation is required.
     343.  If you want to use the "PM Default Browser/Mail" setting to open links
     35    within chat windows, make sure that you have the default PM broser and
     36    mail client applications set up correctly.  The easiest way to do this is
     37    to use the "Configure Internet Applications" tool from Hobbes
     38    (http://hobbes.nmsu.edu/pub/os2/apps/misc/configapps1_1_1.zip).
     39
     40Please refer to the Trobuleshooting section below for additional information
     41on how to resolve problems you may encounter when running Psi for OS/2.
    3842
    3943
    40 Configuration data
     44Upgrading to a New Vesion
     45-------------------------
     46
     47If you are upgrading your installation from a previous version of Psi, please
     48always use a clean directory to install the new version to avoid possible file
     49conflicts.
     50
     51Please note that installing a new version to a clean directory will not affect
     52your existing personal configuration data (Psi profiles, account settings,
     53message history) because it is stored in a separate directory and therefore
     54will be preserved.  It is however recommended to make a backup copy of all
     55configuration data before starting a new version of Psi for the first time
     56(to protect from accidential data loss due to possible changes in formats of
     57configuration files).  Refer to the section called "Configuration Data" for
     58more details about where this data is stored.
     59
     60Note that if you want to run two different versions of Psi simultaneously
     61(in general, there is no such a need, but just to let you know), you will have
     62to create and use a .CMD script that sets the following environment variables
     63prior to starting the Psi executable:
     64
     65    set BEGINLIBPATH=<path_to_Psi_exe>
     66    set LIBPATHSTRICT=T
     67
     68
     69Configuration Data
    4170------------------
    4271
    43 Psi stores all configuration files in the subdirectory /PsiData of
    44 your home directory (pointed to by the HOME environment variable).
     72Psi stores all configuration files (such as Psi profiles, account settings,
     73message history, etc.) in the subdirectory /PsiData of your home directory
     74(pointed to by the HOME environment variable).  Note that if the HOME variable
     75is invalid or points to a non-existing location, the /PsiData subdirectory
     76will be created in the root directory of the boot drive.
    4577
    46 The name of the last used Psi profile is stored in the registry
     78The name of the last used Psi profile is stored in the Open32 Registry
    4779under the key HKEY_CURRENT_USER\Software\Affinix\psi.
     80
     81The paths and parameters to the default PM browser and mail client applications
     82are taken from the HINI_USER_PROFILE\WPURLDEFAULTSETTINGS registry key (stored
     83in the X:\OS2\OS2.INI file).
     84
     85
     86Troubleshooting
     87---------------
     88
     89This section describes known problems you may encounter when running
     90Psi for OS/2, together with possible solutions.
     91
     921.  If you have a single-streamed sound card (a card that cannot play
     93    more than one sound at a time) and experience problems with sound
     94    in Psi (such as 100% CPU load when playing too many sounds
     95    simultaneously), try to add the following line to CONFIG.SYS
     96    (or to the .CMD script that starts Psi):
     97
     98        SET QT_PM_NO_SOUND_SHARE=YES
     99
     100    This will tell the Qt library to open sound devices in the
     101    exclusive mode.
    48102
    49103
    … …  
    51105----------------------------------
    52106
    53 1.  Using the PM Default Browser/Mail choice for opening links doesn't
    54     work yet. The Custom browser setting requires a command like
    55     'cmd /c cd D:\Apps\Firefox & D:\Apps\Firefox\Firefox.exe'.
    56    
    57 2.  SSL connection is completely untested and will most likely not work.
     1071.  PGP encryption is completely untested and probably will not work.
    58108
    59 3.  PGP encryption is completely untested and probably will not work.
     1092.  The global hot keys are not available.
    60110
    61 4.  The global hot keys are not available.
    62  
    63 5.  Idle (i.e. Auto-Away) detection may not work properly.
     1113.  Idle (i.e. Auto-Away) detection is only sensitive to mouse movements,
     112    meaning that Psi will go away if the mouse is not moved durng the specified
     113    amount of time, regardless of whether one presses something on the keyboard
     114    or not.  Likewise, using the keyboard will not cancel the Auto-Away state.
    64115
    65 6.  The directory watcher service is not available (though I don't yet know
    66     what is it good for in Psi).
     1164.  The directory watcher service is not available (affects PGP encryption
     117    support).
    67118
    68 7.  There is no "tray icon" (xCenter widget) for Psi. It will be available
     1195.  There is no "tray icon" (xCenter widget) for Psi. It will be available
    69120    later.
    70121   
    71 8.  Power management events such as "sleep" or "wakeup" are not detected by Psi.
     1226.  Power management events such as "sleep" or "wakeup" are not detected by Psi.
    72123
    73 9.  Drag and Drop support in Qt/OS2 is not yet finished, so there are few
     1247.  Drag and Drop support in Qt/OS2 is not yet finished, so there are few
    74125    known issues (for example, text in entry fields may be corrupted when the
    75126    drag object is moved over them).
    76127
    77 10. The "Roaster window always on top" option is temporarily removed from the
     1288.  The "Roster window always on top" option is temporarily removed from the
    78129    options dialog because this functionality is not yet available in Qt/OS2.
    79130
     1319.  DBCS characters can neither be entered nor displayed correctly
     132    (current Qt limitation).
    80133
    81 Bug Reports
    82 -----------
    83 
    84 To submit a bug report, please visit http://svn.netlabs.org/qt3/ticket/25
    85 and add a comment describing the problem.
    86 
    87 Note that in order to add a comment, you'll need to login to the Trac system
    88 using the special name and the password presented on the start page
    89 (http://svn.netlabs.org/qt3/wiki). 
    90 
    91 
    92 Contributors
    93 ------------
    94 
    95 Thanks to the following people who contributed to Psi/2:
    96 
    97 Ivan Smirnoff
    98     www.sampo.ru/~bigvic
    99         OS/2 icon
    100 
    101 Juergen Ulbts
    102     WarpIn scripts
    103 
    104 
    105 Changes
    106 -------
    107 
    108 Note: fixes marked as [Qt ...] are applied to the Qt library for OS/2,
    109 not to Psi itself.
    110 
    111 *   Version 0.10-os2-b1 (2006-08-18)
    112     --------------------------------
    113 
    114     - Built using Qt 3.3.1-RC7 SVN build r118.
    115 
    116     - New: Chat tabs can be switched using Ctrl+Tab and Ctrl+Shift+Tab
    117       combinations (together with cross-platform Ctrl+PgUp/Ctrl+PgDn).
    118 
    119     - New: Pressing the Esc key in the Roster window minimizes it
    120       if the Doclet widget (tray icon) is disabled (which is always true
    121       on OS/2 since there is no xCenter/SysTray integration yet).
    122 
    123     - Fixed: Removed the Options->Sound->Player entry field (not used in
    124       OS/2).
    125 
    126     - Fixed: Unpainted vertical strip in QToolBar (seen to the left from the
    127       Clear chat window button) [Qt bug].
    128 
    129     - Fixed: Pressing AltGr+key could produce valid characters in some
    130       keyboard layouts (i.e. the German one) which were ignored in the chat
    131       window [Qt bug].
    132 
    133     - Fixed: In the roster: pressing the Status button right after pressing
    134       the Psi button didn't unpress the latter (and vice versa) [Qt bug].
    135 
    136     - Fixed: Notification popups didn't take the desktop work area size into
    137       account (appeared over the xCenter widget) [Qt enhancement].
    138 
    139     - Fixed: Playing too many sounds simultaneously could screw up a
    140       single-streamed audio driver and cause the application hang during
    141       termination or even a crash [Qt improvement].
    142 
    143     - Fixed: All network activity (including file transfer) was suspended
    144       during moving or resizing Psi windows using the mouse [Qt improvement].
    145 
    146     - Fixed: Selecting 'Rerequest authorization from' in the context menu
    147       of ICQ and Transport contacts in the Roster would crash Psi.
    148 
    149     - Fixed: Opening the chat window could sometimes crash Psi (SIGFPE)
    150       [Qt bug].
    151 
    152     - Fixed: When both "Open chats in tabbed mode" and "Raise chat window on
    153       receiving new messages" were set, receiving a new message would bring
    154       the chat window to front but would not change the active tab to the one
    155       corresponding to the chat window.
    156 
    157     - Fixed: Closing Psi trying to connect (resolve the server name) when
    158       there was no Internet connection hid all Psi windows but didn't exit
    159       the process until the request timed out (that could take quite a
    160       long and didn't allow to start another Psi instance).
    161 
    162 
    163 *   Version 0.10-os2-a1 (2006-07-25)
    164     --------------------------------
    165    
    166     The first public alpha version.
Note: See TracChangeset for help on using the changeset viewer.