Waitforkey

WaitForKey
----------
Still the same version, but recompiled using the famous vbcc compiler 
by Volker Barthelmann and Frank Wille. The resulting code is much,
MUCH smaller! vbcc compliant makefile provided.

- What is it?

WaitForKey - a utility for shell scripts, which empowers the developer to
interrupt the script execution and to wait for a key press by the user.

- How does it work?

Template:
---------
WaitForKey TEXT/F

The parameter TEXT is optional and is useful for printing out some 
explanatory text, as soon as WaitForKey waits for a key press. The
default text is "Please press any key.", which should be
understandable for most users ;)

- Are there any restrictions?

WaitForKey doesnt recognize all key presses. Keys like Crtl, Amiga, etc.
are not recognized at all.

If theres an input redirection established and the input device is
"non-interactive", then WaitForKey DOESNT WAIT for a key press and ends
without any further report. Script execution continues without break.
Input devices like e.g. terminals, connected to the serial port, should
work, but this wasnt tested.

- Who did it?

Idea: aPEX
Code: Thomas Rapp
Additional code: Wolfgang Hosemann

- Why?

aPEX likes to have an OS4 native version. So Thomas spent some code and
know how, and Wolfgang "tuned" this code a bit to cure certain drawbacks. 
And heres WaitForKey.

- But theres WaitAnyKey?

Yes. aPEX likes to have an OS4 native version ;)

- WaitAnyKey doesnt work with OS4?

It does. aPEX likes to have an OS4 native version ;))

- Why dont you name it WaitAnyKey, too?

Because WaitAnyKey exists for 68k only. To prevent any confusion, the OS4 
version is named WaitForKey. This describes the function a bit more accurate, 
too ;)

- What to do if there are any problems with WaitForKey?

Ask. Or improve it yourself. WaitForKey is public domain and source code is
provided.