Gkrellm WHO2 Plugin
===================

This plugin displays currently logged in users in the scrolling line.
It also shows number of logins for each username and may show idle status.

How it works
============

GkrellmWHO2 uses the most standard unix program `w' to determine the list
of logged in users. Since 0.2 version it takes four different ways to
determine the user's login name by whom it is started. Exaclty it checks
'USER' and 'LOG_NAME' environment variables and then runs `who am i' and
`whoami' commands. Each step is taken only if prevoius failed.

If no users are logged in, the 'no users' string is displayed. In the
other case, users' names are displayed in a scrolling line one by one,
each followed by number of opened sessions and optionally the so called
'away status'. Names may be sorted in alphabetical order and/or by idle
status. The away status is figured out of the minimal idle time for each
user. They are 'act' for active users (by default, the ones whos idle time
is less than 10 minutes), 'away' (if the idle time is between 10 and 30
minutes) and 'gone' (if idle is bigger than 30 minutes).

0.2.8 adds a little new feature of notification command execution and
fixes the upstream link problem from previous version.
0.2.7 seems to be the last fix release before 1.0. Also preparing to go
into official debian.
Since 0.2.6 plugin works correctly under FreeBSD.
Since 0.2, users' names are coloured corresponding to their idle status.
Sorting featrues are added in 0.2.4.
There's also a tooltip with all the users listed in 0.2.

Configuration
=============

The configuration is very easy as seen in the following brief explanation.
* show users' idle status - this is the switch that enables showing idle
							status (act, away and gone)
* scrolling speed - defines the amount of pixels which the line is moving by
* update frequency (sec) - defines how often the information is updated
* sort users by idle status - users will be sorted by idle status so that
							'active' ones will go first, then 'away' and
							then 'gone'
* sort users by name - users will be sorted by their login names
* away time (sec) - defines the amount of time in seconds after which the
					user is marked 'away'
* gone time (sec) - defines the amount of time in seconds after which the
					'away' user is marked 'gone'
* act color,	  - colors for each idle status
* away color,	  - colors for each idle status
* gone color	  - colors for each idle status


It is very simple in use and a bit configurable and I hope it does more
than enough for now.

For details on usage, see the info page in the GkrellmWHO2 configuration
tab.