unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Richard M. Stallman" <rms@gnu.org>
Cc: storm@cua.dk, monnier@iro.umontreal.ca, emacs-devel@gnu.org
Subject: Re: Function for deleting a key binding in a sparse keymap
Date: Tue, 13 Dec 2005 12:50:03 -0500	[thread overview]
Message-ID: <E1EmEHr-0000yu-2m@fencepost.gnu.org> (raw)
In-Reply-To: <439DCAEA.5080204@student.lu.se> (message from Lennart Borgman on Mon, 12 Dec 2005 20:09:30 +0100)


    First the keyboard input events must be translated (@pxref{Translating
    Input}).  This is done in two steps, first character translation and
    then key sequence translation:

I don't think that belongs in this node.  These things should be
documented elsewhere.  What is needed here is a brief statement that
key lookup is separate from key input, with mention of
read-key-sequence, and an xref.

    The keymap entry could also be a keymap.  In that case the next event
    is looked up in that keymap.  

    (@strong{But what happens if there is no hit there, I can not find any
    documentation on this???})

The question is not clear.  "No hit there"--where is "there"?

    @lisp
    (or (if overriding-terminal-local-map
	    (FIND-IN overriding-terminal-local-map)
	  (if overriding-local-map
	      (FIND-IN overriding-local-map)
	    (or (FIND-IN (get-text-property (point) 'keymap))
		(FIND-IN-ANY emulation-mode-map-alists)
		(FIND-IN-ANY minor-mode-overriding-map-alist)
		(FIND-IN-ANY minor-mode-map-alist)
		(FIND-IN (get-text-property (point) 'local-map))
		(FIND-IN (current-local-map)))))
	(FIND-IN (current-global-map)))

Please use @var instead of capital letters.

    @noindent
    @strong{Remark 2:} Characters that are bound to
    @code{self-insert-command} are translated according to
    @code{translation-table-for-input} before insertion.

How self-insert-command works is not part of this topic.
It might be desirable to add this info somewhere else,
but here it does not belong.

    @noindent
    @strong{Remark 3:} You may find the function
    @code{current-active-maps} useful when looking into this.

Such vagueness is unhelpful.  Please say what the function does.
Then add an xref to it.

  reply	other threads:[~2005-12-13 17:50 UTC|newest]

Thread overview: 48+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2005-12-08  9:32 Function for deleting a key binding in a sparse keymap LENNART BORGMAN
2005-12-08 14:24 ` Kim F. Storm
2005-12-08 15:03   ` Lennart Borgman
2005-12-08 16:53 ` Stefan Monnier
2005-12-08 18:36   ` Lennart Borgman
2005-12-08 18:56     ` Stefan Monnier
2005-12-08 23:59       ` Lennart Borgman
2005-12-09 11:24         ` Kim F. Storm
2005-12-09 15:03         ` Richard M. Stallman
2005-12-09 20:12           ` Lennart Borgman
2005-12-10  4:13             ` Richard M. Stallman
2005-12-10 23:45               ` Lennart Borgman
2005-12-11  1:12                 ` Stefan Monnier
2005-12-11  2:16                   ` Lennart Borgman
2005-12-11  8:14                     ` Stefan Monnier
2005-12-11 16:49                     ` Richard M. Stallman
2005-12-11 16:49                 ` Richard M. Stallman
2005-12-12  1:41                   ` Lennart Borgman
2005-12-12 15:52                     ` Stefan Monnier
2005-12-12 17:02                       ` Lennart Borgman
2005-12-13 15:52                         ` Stefan Monnier
2005-12-12 16:18                     ` Richard M. Stallman
2005-12-12 19:09                       ` Lennart Borgman
2005-12-13 17:50                         ` Richard M. Stallman [this message]
2005-12-14  0:50                           ` Lennart Borgman
2005-12-14 20:02                             ` Richard M. Stallman
2005-12-10 23:40             ` Kim F. Storm
2005-12-11  0:29               ` Lennart Borgman
2005-12-11  0:54                 ` Lennart Borgman
2005-12-11 16:49                   ` Richard M. Stallman
2005-12-08 23:14     ` Function for deleting a key binding in a sparse keymap - bug in menus? Lennart Borgman
  -- strict thread matches above, loose matches on Subject: below --
2005-12-04 23:58 Function for deleting a key binding in a sparse keymap Lennart Borgman
2005-12-05 16:38 ` Richard M. Stallman
2005-12-05 16:55   ` Lennart Borgman
2005-12-06 16:42     ` Richard M. Stallman
2005-12-06 17:04       ` Lennart Borgman
2005-12-06 21:26         ` Stefan Monnier
2005-12-06 22:18           ` Lennart Borgman
2005-12-06 22:28             ` Stefan Monnier
2005-12-06 23:01               ` Lennart Borgman
2005-12-07  1:56                 ` Stefan Monnier
2005-12-07  9:56                   ` Lennart Borgman
2005-12-07 10:13                   ` Lennart Borgman
2005-12-07 14:33                     ` Lennart Borgman
2005-12-08  9:10                       ` Kim F. Storm
2005-12-07 17:06         ` Richard M. Stallman
2005-12-07 17:12           ` Lennart Borgman
2005-12-05 19:42 ` Stefan Monnier

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=E1EmEHr-0000yu-2m@fencepost.gnu.org \
    --to=rms@gnu.org \
    --cc=emacs-devel@gnu.org \
    --cc=monnier@iro.umontreal.ca \
    --cc=storm@cua.dk \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).