How to define a Hot Key
***********************

   This chapter describes how to define a Hot Key as an Input
Description String, which is then parsed by Commodities. Each time a
Hot Key is activated Commodities generates an event which is used by
ToolManager to activate Exec objects or to toggle Dock objects. A
description string has the following syntax:

     [] {[-][]} [-][upstroke] []

   All keywords are case insensitive.

       class describes the InputEvent class. This parameter is optional
and if it is missing the default rawkey is used. See  InputEvent classes.

   Qualifiers are "signals" that must be set or cleared by the time the
Hot Key is activated; otherwise no event will be generated. For each
qualifier that must be set you supply its keyword. All other qualifiers
are expected to be cleared by default. If you want to ignore a
qualifier, just set a - before its keyword. See  Qualifiers.

   Normally a Hot Key event is generated when a key is pressed. If the
event should be generated when the key is released, supply the keyword
upstroke. When both press and release of the key should generate an
event, use -upstroke.

   The key code is depending on the InputEvent class. See  Key codes.


  InputEvent classes 
  Qualifiers 
  Key codes 
  Hot Key examples 

   Note: Choose your hot keys carefully, because Commodities has a high
priority in the InputEvent handler chain (i.e. will override existing
definitions).