From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Hong Xu Newsgroups: gmane.emacs.bugs 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 Message-ID: References: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> <2e495171-34f8-436e-9fc5-334bd93fde00@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="t15etnqqyDrptYTMZVWm5UWhbfGnob2T7" X-Trace: blaine.gmane.org 1522174990 21144 195.159.176.226 (27 Mar 2018 18:23:10 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 27 Mar 2018 18:23:10 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 Cc: 30958@debbugs.gnu.org To: Drew Adams , Andreas Schwab Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Mar 27 20:23:05 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0tFR-0005Pp-Fh for geb-bug-gnu-emacs@m.gmane.org; Tue, 27 Mar 2018 20:23:05 +0200 Original-Received: from localhost ([::1]:35584 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f0tHU-0000EE-OM for geb-bug-gnu-emacs@m.gmane.org; Tue, 27 Mar 2018 14:25:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51153) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f0tHN-0000Ck-B1 for bug-gnu-emacs@gnu.org; Tue, 27 Mar 2018 14:25:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f0tHK-00010J-5R for bug-gnu-emacs@gnu.org; Tue, 27 Mar 2018 14:25:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:48329) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1f0tHK-000107-11 for bug-gnu-emacs@gnu.org; Tue, 27 Mar 2018 14:25:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1f0tHJ-0006wW-PI for bug-gnu-emacs@gnu.org; Tue, 27 Mar 2018 14:25:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Hong Xu Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 27 Mar 2018 18:25:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 30958 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 30958-submit@debbugs.gnu.org id=B30958.152217509926675 (code B ref 30958); Tue, 27 Mar 2018 18:25:01 +0000 Original-Received: (at 30958) by debbugs.gnu.org; 27 Mar 2018 18:24:59 +0000 Original-Received: from localhost ([127.0.0.1]:56226 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0tHH-0006wB-6t for submit@debbugs.gnu.org; Tue, 27 Mar 2018 14:24:59 -0400 Original-Received: from sender-of-o52.zoho.com ([135.84.80.217]:21408) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0tHF-0006w3-Ii for 30958@debbugs.gnu.org; Tue, 27 Mar 2018 14:24:57 -0400 Original-Received: from [192.168.88.88] (cpe-104-32-170-214.socal.res.rr.com [104.32.170.214]) by mx.zohomail.com with SMTPS id 1522172353593773.6025074411161; Tue, 27 Mar 2018 10:39:13 -0700 (PDT) In-Reply-To: <2e495171-34f8-436e-9fc5-334bd93fde00@default> X-Zoho-Virus-Status: 1 X-ZohoMailClient: External X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:144654 Archived-At: This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --t15etnqqyDrptYTMZVWm5UWhbfGnob2T7 Content-Type: multipart/mixed; boundary="xIs86QDpUMWXGsb8IQv9Kl4zaEF6wFuKE"; protected-headers="v1" From: Hong Xu To: Drew Adams , Andreas Schwab Cc: 30958@debbugs.gnu.org Message-ID: Subject: Re: bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap' References: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> <2e495171-34f8-436e-9fc5-334bd93fde00@default> In-Reply-To: <2e495171-34f8-436e-9fc5-334bd93fde00@default> --xIs86QDpUMWXGsb8IQv9Kl4zaEF6wFuKE Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable 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 a= s >> listed in the doc for define-key. >=20 > Yes, I think that is the point: what a keymap is, and so > what its entries are that are being mapped over. >=20 > 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. >=20 > 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. >=20 > I don't really have a suggestion for this, but maybe > Hong Xu does. >=20 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 --xIs86QDpUMWXGsb8IQv9Kl4zaEF6wFuKE-- --t15etnqqyDrptYTMZVWm5UWhbfGnob2T7 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEExhpJYaW1K1QSOB5eJmx9M4IvhHgFAlq6gb0ACgkQJmx9M4Iv hHjJOg/5Ae9T8+7QPapLaPcvSXlPlDj+RNLWgbyXYtAO+V18XOHLHsWP68LYiQTs 6puIv0KRf4EICNUPMi1+uZbUx/fveDeaIG1U10hFb2bfIAXk0U/H/JAM448ql6U4 J7g9lWe6doKtO+4XhxQRCrmwt7NhqPWOwqfdWZWtyp2c6Z7MF9V/OHbZHNZsMf61 mtgk29/VCah1TyR0se/kbxlLI81GpY0a73ER00Sy7tjma3NDLCPo/UCc9pC83Wdm rNoJKnAuw1sqXZf8WbSb7qcuavj6828eTAVw+eCuhNGDcw4cDcaoQBBDH8jxSMtW Jw1TFqbnz3K8vwAnIP3XSoXfDtPmT/JfhDVjFGehnfIf0jpfudrCn2ylt+SfAyKJ ChAVhSY4aqsrJsYp2xo4nAJc1ivscffnLeT9V6jDtcd4NpupojrD/oYkoF5tkY61 J4wySUNnkkZ3bYetiGDFs4g8E2jmn4yIQHm/f284jN0pi3E8Eg8QCLryenkLIXq3 O5oNqtab4y4jqgJPNEqEsRVyu0gt643bCW+yP2Z9FHMNW6tJrHFy8+0VeAm6nnN/ Nwe2fJogTwgNcEK6HkKGdyu6Fsm+EtQ4U2oT22QSs7An97qRD+dphLC5Sp+dYY8+ vfGhZItU2ZEpTLA1Qmi75mgMQVrY1aCx1V+Zx+klOdNA6ltzNU0= =CFKz -----END PGP SIGNATURE----- --t15etnqqyDrptYTMZVWm5UWhbfGnob2T7--