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 chained 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-keymap:aug-keymap-mixin chain-to-keymap next prefix?) -> void
      next : (instance keymap%)
      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.

  Keeps a list of the keymaps chained to this one.