The QL Toolbox '98 Collection
-----------------------------

WhatKey - What IS the ASCII Code of that Key?
---------------------------------------------
This little utility is so simple it really shouldn't need a manual. WhatKey is
yet another of those programs that displays the ASCII code of the key you just
pressed. The only difference is that WhatKey runs under the Pointer
Environment, so it can be moved around the screen to suit your preference, and
even turned into a button when you don't need it.

After starting the program, click on the big "Show Keycodes" item. Every key
that you press will then be displayed in the output window, along with its
corresponding ASCII code. The code is also put into the HotKey System II
Stuffer Buffer, so you can [ALT]+[SPACE] it into that S*BASIC program you've
been trying to finish.

Hitting the [ESC] key takes you out of keystroke mode, so that WhatKey's window
can be moved around, Buttonised, or you can quit the program.

And that's all folks. I have this on [ALT]+[K]. Perhaps one day I will be able
to quote any keycode off by heart but, until that day, WhatKey is a useful aid.

Command Line
------------
If you pass the string '/x' as a command line to WhatKey, it will start
up in keystroke mode straight away, and every key you press will display the
relevant code. Pressing [ESC] will exit from the program at once while in
this mode. Passing /W in the string as well, will stay in the program after
you press [ESC].

Configuration
-------------
WhatKey may be configured using the Level 1 or Level 2 Config programs. A
single flag can be set to indicate whether WhatKey stuffs the code of each
last key pressed into the Stuufer Buffer, or puts the full description and
code into the Scrap.

Revision History
----------------
0.40    15/02/1998      First version.
0.45    23/02/1998      Added support for /W switch.
                        Added config item to set where code is sent.
                        Shows the 'name' of the [TAB] and [ENTER] keys
                        instead of [CTRL]+[I]/[J].
0.50    01/03/1998      Discards any channels passed (was causing a
                        problem executing job out a shell program)

The program was compiled with QLiberator 3.33, and the 3.36mod runtimes. The
file WhatKeyRT_obj includes bound runtimes.

License Terms
-------------

You are granted a license to use and distribute this software. The
terms of this license are stated below.

Provided that credit is given to the author, and that such credit is
included in any accompanying documentation, whether it be on written
or electronic media ...

1) This program may be freely distributed.

2) This program and its documentation may be incorporated as part of
another package, so long as it does not form the major or substantial
part of such package, and so long as, when taken in combination with
other programs supplied by the author under the same terms, the programs
together do not form the major or substantial part of that package.

3) The executable(s) may be modified, or patched, as necessary, to suit
different target environments. However, where such alterations are made,
and the executables are distributed, details of these changes must also
be included in electronic or written form.

No charge may be made for this program, other than reasonable costs of
electronic media and data transmission to facilitate its distribution.

The author gives no warranty as to the suitability of the program, or
the accuracy of the documentation. The programs are supplied 'as-is'.
It is the responsibility of the user to establish whether the program
is suitable and safe to use in his/her environment.

The author accepts no responsibility for any data that is lost or
corrupted as a result of using this program.

The author will make his best endeavours to fix any problems that are
reported to him, but does not accept an obligation to do so. The author
may be contacted via the E-Mail address quoted at the foot of this
document.


Adrian.D.Ives
ADIves@aol.com
01/03/1998
