____________________________________________________________

 Systray/2 1.0 beta 3                           (17/11/2000) 
____________________________________________________________
                                   Russian Team OS/2 project


 1. What is it?
 2. Description
 3. Tray API
 4. Known problems
 5. Sources
 6. What's next?
 7. Your help
 8. Author, thanks and contacts

(see also readme.rus for this document in russian)



1. What is it?
==============

 Systray is what we deal with when we work with operating 
 systems Windows '95/98/NT. Actually besides task switcher 
 it is a convenient utility called system tray. 
 Tray is  a section of the screen assigned for the programs 
 not seen in the screen at the moment but active and performing 
 an operation which the user can control through the tray.
 It differs from task switcher in several aspects:

 The program that has its icon on the tray manages this icon 
 by itself. The user s manipulations over the program are sent 
 as a message to it and operate it through the pop-up menu.    

 The program gets the mechanism allowing to inform the user about 
 the process of performing an operation.  E.g. ReGet, ICQ, The Bat.



2. Description of the program.
==============================

 2.1. Installation

 To install the program start script  install.cmd that 
 will create folder Systray/2, objects of the program 
 and documentation as well as Systray/2 shadow in 
 Startup folder.
 After that you can start object Systray with settings 
 by default (INI-file "systray2.ini" will be used).


 2.2. Settings and options

 Main points of settings are unlikely to give rise to any 
 questions or problems and will be described in the 
 final documentation which will also contain a brief 
 description of base plug-in content Systray.dll. Plug-in 
 consist of units that are separate completed programs 
 able to function under Systray/2 management.

 A standard plug-in includes:

 SystrayClockClass  	shows the current time, one can 
                        indicate in settings:
			- displaying seconds;
			- displaying date;
			- 12-hours mode.

			Background of the clock window
 			and font used for displaying the time 
			can be changed by drag-and-drop from 
			the corresponding OS/2 palettes.
			
 
 SystrayToolbarClass	Toolbar, analogue of Launchpad or 
			Tray from WarpCenter Is used for 
      			customizable quick access bar to the 
			programs. This module settings allow to 
			- indicate which programs will be in the Toolbar';
			- their order;
			- start parameters and working directory					
			
 SystrayDiskMonitor	Free space on the disk monitor

SystraySwapMonitorClass Monitor of system swap-file

 SystrayClass		System tray for displaying and managing 
			working processes.

 SystrayTaskbarClass	Task switcher. Its settings:
			- not to show the icons of the 
			  processes (only names);
			- select the type of buttons of tasks 
			  (Warp4 or Warp3);
			- the size of buttons of tasks ("stretching"
			  to the width).

			Besides task switcher has filters and
			Can hide certain processes from the list 
			of tasks. The filters are set up both 
			from the settings window of the module 
			and by the right click on the processes.			 

			The right click on the task button can 
			also cancel its work (point "Close"). 
			
SystrayUptimeClass 	System uptime. New!!

SystrayCPUMonClass 	CPU Load Monitor. New!! 
			Please inform us if this module doesn't work well.


 It is not recommended to create more than one SystrayClass or 
 SystrayTaskbarClass object. 

 You can start several copies of systray simultaneously.



3. Tray API.
============

 The  use of Tray API is shown in the example trayex.exe with 
 switched on tray. The example is rather simple. With the help 
 of Tray API a lot can be done, API documentation is finishing. 
 Meanwhile you can get the sources of the example. 



4. Known problems.
==================

 If you started version Systray alpha 1 before 
 delete keys HINI_USER_PROFILE\NewSystray from system registry (OS2.INI).
 You can do it with the help of REGEDIT2.



5. Sources
==========

 All Systray/2 sources are opened and included into distribution.

 In future (first beta), Systray/2 sources will be opened 
 under GPL-like license.



6. What's next? 
===============

 SOM-agent for WPS/SOM objects manipulation - already in alpha-version.
 If you will to test it - contact us! 

 Maximized windows control like warpcenter or Filebar;

 New classes: virtual desktop manager, CPU load monitor;

 Trays in Toolbar class;

 Popup menus for all classes;

 Taskswitcher enchancements: minimize active window by mouse click
 on window's button in taskswitcher; CPU load reduce;

 Improved Plugin & Tray API documentation with VP/2 sources.


 
7. Your help
============

 If you are programmer - see development subdirectory of this archive.

 All Systray sources and some documentation (Plugin making reference,
 System Tray API reference) is included  - you are welcome to support
 YOUR SOFTWARE in system tray. 

 Tray API now available in C language (We work with Watcom) and 
 Virtual Pascal 2.x
 
 Ok, You may also create new plugins. Please let us know about your
 plans in this case and we'll include yours plugins into next releases.



8. Author, thanks and contacts.
===============================

 The main developer is me, Dmitry Zakharov,  MadInt13h at #OS2Russian.
 Special thanks to Konstantin Okounkov for the idea and kicks that 
 made me fulfill it. :).

 Dmitry Zakharov (madint@os2.ru)	programming, design, ideas
 Konstantin Okounkov (admin@os2.ru)	web-hosting, russian docs, ideas 


 Special thanks to:

 Irina Koudina (irink@os2.ru)		translation 
 Vit Timchishin (tvv@os2.ru)		translation (dev.docs)
 Sergey I. Yevtushenko (es@os2.ru)	programming questions


 Systray Homepage			http://os2.ru/projects/systray

____________________________________________________________
Systray/2 	Copyright () 1999-2000,   Russian Team OS/2
