From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lennart Borgman Newsgroups: gmane.emacs.devel Subject: Re: Function for deleting a key binding in a sparse keymap Date: Sun, 11 Dec 2005 01:54:44 +0100 Message-ID: <439B78D4.9020909@student.lu.se> References: <3cc04a73cc1b1a.3cc1b1a3cc04a7@net.lu.se> <43987D21.4070200@student.lu.se> <4398C8F2.8060301@student.lu.se> <4399E538.2080909@student.lu.se> <439B72F4.9080200@student.lu.se> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------020403040002090606080306" X-Trace: sea.gmane.org 1134262548 18806 80.91.229.2 (11 Dec 2005 00:55:48 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 11 Dec 2005 00:55:48 +0000 (UTC) Cc: emacs-devel@gnu.org, rms@gnu.org, monnier@iro.umontreal.ca Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 11 01:55:37 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1ElFUi-0001nn-SI for ged-emacs-devel@m.gmane.org; Sun, 11 Dec 2005 01:55:17 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ElFV8-000795-I3 for ged-emacs-devel@m.gmane.org; Sat, 10 Dec 2005 19:55:42 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1ElFUv-00078o-PN for emacs-devel@gnu.org; Sat, 10 Dec 2005 19:55:29 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1ElFUv-00078c-7B for emacs-devel@gnu.org; Sat, 10 Dec 2005 19:55:29 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ElFUv-00078Z-4f for emacs-devel@gnu.org; Sat, 10 Dec 2005 19:55:29 -0500 Original-Received: from [81.228.8.164] (helo=pne-smtpout2-sn2.hy.skanova.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1ElFWM-0000BK-KX; Sat, 10 Dec 2005 19:56:58 -0500 Original-Received: from [192.168.123.121] (83.249.218.244) by pne-smtpout2-sn2.hy.skanova.net (7.2.060.1) id 43960D0D0012EEDA; Sun, 11 Dec 2005 01:54:45 +0100 User-Agent: Mozilla Thunderbird 1.0.7 (Windows/20050923) X-Accept-Language: en-us, en Original-To: "Kim F. Storm" In-Reply-To: <439B72F4.9080200@student.lu.se> X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:47415 Archived-At: This is a multi-part message in MIME format. --------------020403040002090606080306 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Lennart Borgman wrote: > Kim F. Storm wrote: > >> May I suggest that you add an example of which part of emacs currently >> uses each of these methods, e.g. >> >> > I have taken your examples. Before I send a new version: How do I make > a cross-reference in Texinfo to cua-mode and viper here? I have attached my new version here. I realize there are more things that should be converted from @code to @ref, but I need some help to finish that. --------------020403040002090606080306 Content-Type: text/plain; name="finding-keymap.texi" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="finding-keymap.texi" @subsection Finding the keymap to use The list below describes step by step how Emacs finds a keymap from a given key sequence. As soon as a hit is found in any keymap (see @ref{Key Lookup}) then if the keymap entry is a function the search is over. However if the keymap entry is a variable symbol or a string then Emacs restarts with the variable symbol value or the string from FIRST-MAP. The keymap entry could also be a keymap. In that case the next event is looked up in that keymap. (But what happens if there is no hit there, I can not find any documentation on this???) @noindent @emph{Note 1:} When Emacs finally find a function symbol through this process it also checks for command remapping. This just replaces the function symbol with another. It is not recursive. @noindent @emph{Note 2:} Characters that are bound to @code{self-insert-command} are translated according to @code{translation-table-for-input} before insertion. @noindent @emph{Note 3:} You may find the function @code{current-active-maps} useful when looking into this. @table @asis @item START-HERE: First apply @code{extra-keyboard-modifiers} mask to each keyboard character read. @end table @itemize @bullet @item Each character read from the keyboard may be translated according to @code{keyboard-translate-table}. @item Translate meta characters according to @code{meta-prefix-char} to a two character sequence. @example For example, this normally maps M-x into ESC x. @end example @end itemize @table @asis @item FIRST-MAP: Look in @code{special-event-map}. @example For example, this is where the @code{delete-frame} event is handled. @end example @end table @itemize @bullet @item If using @code{read-from-minibuffer} (directly or indirectly) then look in the keymap given as parameter then look in this. Otherwise look in @code{minibuffer-local-map}. @item If using @code{read-no-blanks-input} to read from minibuffer then look in @code{minibuffer-local-ns-map} first and then @code{minibuffer-local-map}. @item If overriding-terminal-local-map look in this. Then go to GLOBAL. @example This is for example used by @code{Incremental Search}. @end example @item If overriding-local-map look in this. Then go to GLOBAL. @item Is there a "keymap" property of the text or overlay at point? @item Look for minor mode keymaps in @code{emulation-mode-map-alists}. @example For example, this is used by @code{cua-mode} and @code{viper}. @end example @item Look for minor mode keymaps in @code{minor-mode-overriding-map-alist} @item Look for minor mode keymaps in @code{minor-mode-map-alist}. @item Is there a @code{local-map} property of the text or overlay at point? @item Is there a "local keymap" (those are for major modes)? @end itemize @table @asis @item GLOBAL: Look in the "current global keymap". (This is returned by @code{current-global-map} and may be different from @code{global-map}, see @code{use-global-map}.) @end table @itemize @bullet @item If it is an ASCII function key sequences then look in @code{function-key-map}. This map transforms to Emacs key sequences. @example This is for example used when running Emacs on a VT-100 terminal. @end example @item The possibly transformed sequence after applying @code{function-key-map} is now handled to @code{key-translation-map} which works the same way. @item If any transformation was made by @code{function-key-map} or @code{key-translation-map} then take the new sequence and go back to FIRST-MAP. @end itemize --------------020403040002090606080306 Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Emacs-devel mailing list Emacs-devel@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-devel --------------020403040002090606080306--