PATCH: pws-24: keymap documentation.

[Peter Stephenson <pws@xxxxxx>]

This explains about the keymap linking business.  Since I only just learned
about it myself, it seems reasonable to suppose it needs documenting.
Please check that I've got it right (though it did seem to work).

--- Doc/Zsh/mod_zle.yo.km	Wed Jun 23 15:48:57 1999
+++ Doc/Zsh/mod_zle.yo	Sun Jun 27 17:05:42 1999
@@ -72,6 +72,17 @@
 )
 enditem()
 
+To use a newly created keymamp, it should be linked to tt(main).  Hence
+the sequence of commands to create and use a new keymap `tt(mymap)'
+initialized from the tt(emacs) keymap (which remains unchanged) is:
+
+example(bindkey -N mymap emacs
+bindkey -A mymap main)
+
+Note that while `tt(bindkey -A) var(newmap) tt(main)' will work when
+var(newmap) is tt(emacs) or tt(viins), it will not work for tt(vicmd), as
+switching from vi insert to command mode becomes impossible.
+
 The following operations require a keymap to be selected:
 
 startitem()

-- 
Peter Stephenson <pws@xxxxxxxxxxxxxxxxx>       Tel: +39 050 844536
WWW:  http://www.ifh.de/~pws/
Dipartimento di Fisica, Via Buonarroti 2, 56127 Pisa, Italy