source: trunk/src/3rdparty/os2/xsystray/README@ 503

Last change on this file since 503 was 333, checked in by Dmitry A. Kuminov, 16 years ago

3rdparty/os2/xsystray: Mention the GNU license in README as well.

File size: 3.3 KB
Line 
1Extended system tray widget for XCenter/eCenter
2Version 0.1.0
3
4Copyright (C) 2009 Dmitry A. Kuminov
5
6Extended system tray widget is free software; you can redistribute it
7and/or modify it under the terms of the GNU General Public License as
8published by the Free Software Foundation, in version 2 as it comes in
9the "COPYING" file of the Extended system tray widget distribution. This
10program is distributed in the hope that it will be useful, but WITHOUT
11ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13more details.
14
15
16
17INTRODUCTION
18
19The extended system tray widget is a plugin for XCenter that provides support
20for the system tray area in the XCenter bar. This area is commonly used by
21long running applications to display their status using graphical icons and to
22provide a way to control these applications by clicking on their icons.
23
24There is a number of other tools to implement the described functionality (for
25example, SysTray/WPS by Dmitry Zaharov and the XCenter plugin for it by Eugene
26Romanenko). The main reason to create yet another implementation is that
27existing ones do not provide the level of functionality required by the Qt
28toolkit for which this extended implementation was created for.
29
30Note that since the SysTray/WPS API is being already used by a number of OS/2
31applications to implement system tray icons (e.g. PM Downloader, CoolFM), the
32Extended system tray widget implements this API as well to provide backward
33compatibility. See the API file for more information.
34
35The word "extended" in the widget name is used to distinguish from the XCenter
36widget by Eugene Romanenko and also to indicate that this one provides some
37extended functionality (for example the ability to add any valid icon to the
38tray, not only the frame window's icon).
39
40
41
42INSTALLATION
43
44In order to manually install the extended system tray widget plugin to XCenter,
45copy xsystray.dll to
46
47 <XWorkplace installation folder>\plugins\xcenter\
48
49If you are using eCenter (rebranded XCenter included in the latest eComStation
50releases), copy xsystray.dll to
51
52 <Boot drive>:\ecs\system\ewps\plugins\xcenter\
53
54Then you should close all XCenter instances and start them again. The system
55tray widget will appear in the widget list under the name "Extended system
56tray".
57
58
59
60UPGRADING
61
62If you are upgrading from the previous version, you should do the following:
63
64 - Unlock the old xsystray.dll file (for example, using unlock.exe from the
65 lxlite package).
66 - Overwrite it with the new xsystray.dll file.
67 - Restart WPS. Note that restarting XCenter is not enough since the old DLL
68 will remain loaded in this case.
69
70The new version should be now picked up automatically.
71
72
73
74HISTORY
75
76... unreleased yet ...
77
78
79
80CREDITS AND COPYRIGHTS
81
82This product uses code from the XWorkplace project (c) by Ulrich Moeller.
83
84SysTray/WPS is copyright (c) by 1999-2002 OS2.Ru DevTeam.
85Syswray widget is copyright (c) by Eugene Romanenko.
86
87Qt is a trademark of Nokia Corporation and/or its subsidiary(-ies).
88OS/2 and OS/2 Warp are trademarks of the IBM Corporation and/or its subsidiary(-ies).
89eComStation is a trademark of Serenity Systems International and/or its subsidiary(-ies).
90
91Etc.
92
Note: See TracBrowser for help on using the repository browser.