Introduction
============

This is a small program I hacked together the other day (hence the brief
documentation ;). It is a small commodity that allows you to add hotkeys
for any screen (that have a title). When you press the hotkey, the screen
in question is brought to the front.

There are two versions of the programs included, ScreenKeys and
ScreenKeys_OS3. The difference is that the latter requires OS 3.0 or
better, and is a tad smaller (about 600 bytes). Apart from that, they
should be equivalent.


Usage
=====

ScreenKeys only supports Workbench startup at the moment. Thus, you should
install ScreenKeys in your WBStartup drawer. The following tooltypes are
available:

CX_PRIORITY
	The priority for the hotkeys.

SCREENKEY
	This tooltype describes the screen and the hotkey for that screen.
	Any number of SCREEKEY tooltypes may be present. First specify the
	pattern describing the screen title, and after that - separated by
	spaces or an equal sign - the hotkey for that screen. If a screen
	pattern or a hotkey contains spaces, quote it. A screen pattern or
	hotkey should not be more than 256 chars, or it will be truncated
	(or an error occurs; I haven't checked ;).

	If a pattern match several screens, and SCREENTOBACK is specified,
	then ScreenKeys will cycle between the matching screens. Thus,
	specifying the screen pattern "#?" will behave the same way as the
	"lcommand m" key. See the included icon for further examples.

	Example: SCREENKEY="Workbench screen" "lcommand w"

SCREENTOBACK
	If this tooltype is present, then the formerly frontmost screen
	will be brought to the back, after the new front screen has been
	brought forward. This is needed to get the screen cycling to work.
	However, there are a few problems with this.

	First of all, it can sometimes be convenient if this doesn't
	happen. Secondly, it doesn't work too well with the attached
	screens in OS 3.0+ (and I don't know of any way to find out if two
	screens are attached or not). With this tooltype you can decide how
	ScreenKeys should behave. If this tooltype isn't specified, then the
	screen cycling will only work for two screens.

The DONOTWAIT tooltype in the icon is for the Workbench, when placed in the
Workbench startup drawer.


Author and other things
=======================

ScreenKeys was written in 1995 by Magnus Holmgren. It is public domain
(source included, though not very well documented ;), so you can do
anything you like with it (although credits would be appriciated ;).
Contact address:

Snail mail:

	Magnus Holmgren
	Kvarnbergsvägen 5
	S-444 47  Stenungsund
	SWEDEN

Electronic mail:

	cmh@lls.e
	cmh@augs.se
	2:204/204.6@fidonet


Version history
===============

	1.0	December 8, 1995

		Initial release.

	1.1	December 9, 1995

		Forgot to reply the Workbench startup message. ;)

	1.2	December 17, 1995

		SCREENTOBACK tooltype added.

		Sigh. Forgot to reply Commodity messages. ;)

		Didn't close icon.library.

		Some minor (size) optimizations.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[unknown]                  195     463  42.1% -lh5- c835 Dec  9  1995 DMakeFile
[unknown]                 2275    3316  68.6% -lh5- ef8e Dec 17  1995 ScreenKeys
[unknown]                 3964   10945  36.2% -lh5- 15b1 Dec 17  1995 ScreenKeys.c
[unknown]                 1286    3012  42.7% -lh5- b6c6 Dec 17  1995 ScreenKeys.info
[unknown]                 1529    3135  48.8% -lh5- f00e Dec 17  1995 ScreenKeys.readme
[unknown]                  945    2123  44.5% -lh5- 7137 Dec  8  1995 ScreenKeys.readme.info
[unknown]                 1787    2688  66.5% -lh5- e6c2 Dec 17  1995 ScreenKeys_OS3
[unknown]                 1284    3012  42.6% -lh5- ea58 Dec 17  1995 ScreenKeys_OS3.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         8 files   13265   28694  46.2%            Dec 18  1995