From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 1121 invoked by alias); 4 Sep 2010 11:32:05 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: X-Seq: 28227 Received: (qmail 5127 invoked from network); 4 Sep 2010 11:32:02 -0000 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-0.9 required=5.0 tests=BAYES_00,DATE_IN_PAST_12_24, RCVD_IN_DNSWL_NONE autolearn=no version=3.3.1 Received-SPF: pass (ns1.primenet.com.au: SPF record at ntlworld.com designates 81.103.221.48 as permitted sender) From: Peter Stephenson To: zsh-workers@zsh.org (Zsh hackers list) Subject: PATCH: documentation on keymap selection X-Mailer: MH-E 8.2; nmh 1.3; GNU Emacs 23.2.1 Date: Fri, 03 Sep 2010 21:47:51 +0100 Message-ID: <4342.1283546871@pws-pc> X-Cloudmark-Analysis: v=1.1 cv=DhNl2YeytwJssBBGe49HJX82LNDFEEVkpVB34RXKaPo= c=1 sm=0 a=ZIdjMYURij8A:10 a=DogomfpGjd0A:10 a=NLZqzBF-AAAA:8 a=Ri8mg0ayoVPpSOzXJPwA:9 a=YNLbN1O4SHivHurF5-yrgs_G5UkA:4 a=_dQi-Dcv4p4A:10 a=HpAAvcLHHh0Zw7uRqdWCyQ==:117 This is intended to improve the documentation on keymaps I noted a couple of weeks ago. It doesn't address the issue that "bindkey -lL" lies about aliased keymaps. Index: Doc/Zsh/zle.yo =================================================================== RCS file: /cvsroot/zsh/zsh/Doc/Zsh/zle.yo,v retrieving revision 1.84 diff -p -u -r1.84 zle.yo --- Doc/Zsh/zle.yo 1 Sep 2010 16:39:32 -0000 1.84 +++ Doc/Zsh/zle.yo 3 Sep 2010 20:44:28 -0000 @@ -149,21 +149,27 @@ xitem(tt(bindkey) [ var(options) ] tt(-r xitem(tt(bindkey) [ var(options) ] tt(-s) var(in-string out-string) ...) xitem(tt(bindkey) [ var(options) ] var(in-string command) ...) item(tt(bindkey) [ var(options) ] [ var(in-string) ])( -tt(bindkey)'s options can be divided into three categories: keymap selection, -operation selection, and others. The keymap selection options are: +tt(bindkey)'s options can be divided into three categories: keymap +selection for the current command, operation selection, and others. The +keymap selection options are: startitem() item(tt(-e))( -Selects keymap `tt(emacs)', and also links it to `tt(main)'. +Selects keymap `tt(emacs)' for any operations by the current command, +and also links `tt(emacs)' to `tt(main)' so that it is selected by +default the next time the editor starts. ) item(tt(-v))( -Selects keymap `tt(viins)', and also links it to `tt(main)'. +Selects keymap `tt(viins)' for any operations by the current command, +and also links `tt(viins)' to `tt(main)' so that it is selected by default +the next time the editor starts. ) item(tt(-a))( -Selects keymap `tt(vicmd)'. +Selects keymap `tt(vicmd)' for any operations by the current command. ) item(tt(-M) var(keymap))( -The var(keymap) specifies a keymap name. +The var(keymap) specifies a keymap name that is selected for any +operations by the current command. ) enditem() @@ -1207,11 +1213,10 @@ mini-buffer. ) enditem() -Any multi-character string that is not bound to one of the above functions -will beep and interrupt the search, leaving the last found line in the -buffer. Any single character that is not bound to one of the above -functions, or tt(self-insert) or tt(self-insert-unmeta), will have the same -effect but the function will be executed. +Any character that is not bound to one of the above functions, or +tt(self-insert) or tt(self-insert-unmeta), will cause the mode to be +exited. The character is then looked up and executed in the keymap in +effect at that point. When called from a widget function by the tt(zle) command, the incremental search commands can take a string argument. This will be treated as a -- Peter Stephenson Web page now at http://homepage.ntlworld.com/p.w.stephenson/