From: Hong Xu <hong@topbug.net>
To: Drew Adams <drew.adams@oracle.com>, Andreas Schwab <schwab@suse.de>
Cc: 30958@debbugs.gnu.org
Subject: bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap'
Date: Tue, 27 Mar 2018 10:39:09 -0700 [thread overview]
Message-ID: <b6b4c767-ead0-ad06-901b-f1b154865950@topbug.net> (raw)
In-Reply-To: <2e495171-34f8-436e-9fc5-334bd93fde00@default>
[-- Attachment #1.1: Type: text/plain, Size: 1596 bytes --]
On 03/27/2018 07:27 AM, Drew Adams wrote:
>>> However, I searched the document, and could not find any useful
>>> information regarding the value of the binding.
>>
>> It is whatever you've put there, see define-key. A keymap is really
>> just a mapping from a key to an arbitrary value, though if the keymap is
>> to be used as a local keymap each value should have one of the forms as
>> listed in the doc for define-key.
>
> Yes, I think that is the point: what a keymap is, and so
> what its entries are that are being mapped over.
>
> The key is to know or look up what a keymap is. Maybe
> this needs to be pointed out better in the doc string?
> Maybe the doc string should point users to the doc about
> keymaps? Typically we don't do that - if a user sees a
> term that is unclear we count on them looking it up.
>
> But maybe it's not clear from the doc string that the
> key here is to know what keymap is? I would think that
> that would be obvious, given that it is a function that
> maps over keymap entries. But maybe it's not.
>
> I don't really have a suggestion for this, but maybe
> Hong Xu does.
>
Thanks, Drew. Actually it's also obvious for me to look up for a keymap
is. What is unobvious is the value of the binding. Even if you go to
"Format of Keymaps", it still does not talk about the actual value of
the binding. The reason it is important for `map-keymap' is that this
seems to be the only place that users need to know the exact value of
binding---in other places, they are operated by some provided functions.
Hong
[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
next prev parent reply other threads:[~2018-03-27 17:39 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-03-25 21:44 bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap' Hong Xu
2018-03-27 4:15 ` Drew Adams
2018-03-27 8:07 ` Hong Xu
2018-03-27 9:35 ` Andreas Schwab
2018-03-27 14:27 ` Drew Adams
2018-03-27 17:39 ` Hong Xu [this message]
2021-10-23 18:03 ` Stefan Kangas
2021-10-23 19:03 ` bug#30958: [External] : " Drew Adams
2021-10-24 6:26 ` Stefan Kangas
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=b6b4c767-ead0-ad06-901b-f1b154865950@topbug.net \
--to=hong@topbug.net \
--cc=30958@debbugs.gnu.org \
--cc=drew.adams@oracle.com \
--cc=schwab@suse.de \
/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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.