HotkeyString.mcc is a simple BetterString.mcc subclass that can convert
user keypresses to the alphabetical representation.

BetterString.mcc recommended but class can fall back to String.mui class.

  HISTORY

  Release 12.1

   - Fixed memory leak bug in the library init code (Gunther Nikl)
   - Optimized code (Gunther Nikl)
   - Final release for now
   - OS4 version, anyone?


  Release 12.0

   - First release, continuation to the last 11.x version from
     Allan Odgaard


  BACKGROUND

Original HotkeyString.mcc class was written by Allan Odgaard years ago
but since he isn't developing for Amiga anymore I wrote my own
implementation. This class is available for MorphOS and AmigaOS-68k
(PPC port for AmigaOS4 is possible) and knows lot more keys than
original class did.


  FEATURES

Following extra keys are now recognized:

  - PageUp, PageDown
  - Home, End
  - Insert
  - PrtScr, Scroll Lock, Pause, NumLock
  - F11, F12
  - Media keys

Also mouse wheel can be a hotkey now.

However, 68k users can't really take advantage of new keys because
commodities.library doesn't translate them. Time for an upgrade,
I think.

For MUI application programmers class provides few new tags.


  ENV VARS

Class looks for MUISTRINGCLASS environment variable. If you wish to
use other string class than BetterString.mcc or String.mui (MUI's
internal string class) simply write name of the class to this env
variable:

setenv MUISTRINGCLASS "<classname>.mcc"


  SOURCE CODE

Source code is available from sourceforge:
http://www.sourceforge.net/projects/hotkeystring


  LEGAL MUNCH

LGPL'd - read License.


  CREDITS


Thanks for Allan Odgaard for writing the original class and giving
a permission to use existing tagbase and documentation in this class.

Thanks for Gunther Nikl for finding memory leak bug (happened only if
BetterString.mcc was not installed) and optimizing 68k version plus
some other nice work for us :)

Reimplementation written by Ilkka Lehtoranta <ilkleht@isoveli.org>.
AmigaOS-68k binary compiled by David Arbuthnot <davar@davar-studios.com>.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1754    2728  64.3% -lh5- edef Oct 29  2003 MCC_HotkeyString/AmigaOS-68k/Demos/HotkeyStringTest
[generic]                 2421    3628  66.7% -lh5- 0cd9 Jan 14  2004 MCC_HotkeyString/AmigaOS-68k/Libs/MUI/HotkeyString.mcc
[generic]                  852    2044  41.7% -lh5- 6544 Oct 28  2003 MCC_HotkeyString/Developer/Autodocs/MCC_HotkeyString.Doc
[generic]                   86      94  91.5% -lh5- fd9e Oct 28  2003 MCC_HotkeyString/Developer/Autodocs/ReadMeNow
[generic]                 1421    3639  39.0% -lh5- 3e79 Oct 28  2003 MCC_HotkeyString/Developer/C/Examples/HotkeyStringTest.c
[generic]                  386     896  43.1% -lh5- 9acf Oct 28  2003 MCC_HotkeyString/Developer/C/Include/MUI/HotkeyString_mcc.h
[generic]                  270     461  58.6% -lh5- cd78 Oct 28  2003 MCC_HotkeyString/Developer/ReadMe
[generic]                  486    1418  34.3% -lh5- 29f8 Jan 14  2004 MCC_HotkeyString/Install
[generic]                 2243    3406  65.9% -lh5- 7fc3 Jan 14  2004 MCC_HotkeyString/Install.info
[generic]                 8747   24351  35.9% -lh5- 64a8 Oct 28  2003 MCC_HotkeyString/LICENSE
[generic]                 1179    2288  51.5% -lh5- 0b32 Jan 14  2004 MCC_HotkeyString/MCC_HotkeyStr.readme
[generic]                26752   26752 100.0% -lh0- aca3 Jan 14  2004 MCC_HotkeyString/MCC_HotkeyStrSrc.lha
[generic]                 3386    6956  48.7% -lh5- 7ebb Jan 14  2004 MCC_HotkeyString/MorphOS/Classes/MUI/HotkeyString.mcc
[generic]                 4472   10132  44.1% -lh5- 69f2 Jan 14  2004 MCC_HotkeyString/MorphOS/Demos/HotkeyStringTest
[generic]                 4562    4700  97.1% -lh5- 3e17 Jan 14  2004 MCC_HotkeyString.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        15 files   59017   93493  63.1%            Jan 18  2004