chain-to-keymap

Multiple keymaps can be chained off one keymap using chain-to-keymap. When keymaps are chained to a main keymap, then events handled by the main keymap are passed to the chained keymaps until a chained keymap handles the events. Keymaps can be chained together in an arbitrary acyclic graph.

Keymap chaining is useful because multiple-event sequences are handled correctly by chianed groups. Dispatching each individual event to separate keymaps is problematic withouth chaining because keymaps may acquire state that must be reset when a callback is invoked in one of the keymaps. This state can be maually cleared with break-sequence, but this also invokes the handler installed by set-break-sequence-callback.

• (send a-wx:keymap chain-to-keymap next prefix) -> void
      next : wx:keymap% object
      prefix : boolean

  If next will be used to handle events which are not handled by this keymap. If prefix is a true value, then next will take precedence over other keymaps already chained to this one.