Changeset 73 for psi/trunk

Show
Ignore:
Timestamp:
09/25/06 00:07:36 (2 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 modified

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.