From unknown Thu Sep 11 04:20:51 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#30958 <30958@debbugs.gnu.org> To: bug#30958 <30958@debbugs.gnu.org> Subject: Status: 26.0.91; No documentation for key and value in the function passed to `map-keymap' Reply-To: bug#30958 <30958@debbugs.gnu.org> Date: Thu, 11 Sep 2025 11:20:51 +0000 retitle 30958 26.0.91; No documentation for key and value in the function p= assed to `map-keymap' reassign 30958 emacs submitter 30958 Hong Xu severity 30958 minor tag 30958 moreinfo thanks From debbugs-submit-bounces@debbugs.gnu.org Mon Mar 26 21:31:45 2018 Received: (at submit) by debbugs.gnu.org; 27 Mar 2018 01:31:45 +0000 Received: from localhost ([127.0.0.1]:54971 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0dSj-0006x9-CN for submit@debbugs.gnu.org; Mon, 26 Mar 2018 21:31:45 -0400 Received: from eggs.gnu.org ([208.118.235.92]:47443) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0dSi-0006ww-0P for submit@debbugs.gnu.org; Mon, 26 Mar 2018 21:31:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f0dSc-0003yL-6e for submit@debbugs.gnu.org; Mon, 26 Mar 2018 21:31:38 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-0.5 required=5.0 tests=BAYES_05 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:39725) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1f0dSc-0003yB-2M for submit@debbugs.gnu.org; Mon, 26 Mar 2018 21:31:38 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:38412) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f0dSb-00040l-1C for bug-gnu-emacs@gnu.org; Mon, 26 Mar 2018 21:31:37 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f0dSX-0003wU-3x for bug-gnu-emacs@gnu.org; Mon, 26 Mar 2018 21:31:37 -0400 Received: from sender-of-o52.zoho.com ([135.84.80.217]:21310) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1f0dSW-0003uY-Rr for bug-gnu-emacs@gnu.org; Mon, 26 Mar 2018 21:31:33 -0400 Received: from [10.0.0.22] (c-67-164-94-228.hsd1.ca.comcast.net [67.164.94.228]) by mx.zohomail.com with SMTPS id 152201429088342.5398074594566; Sun, 25 Mar 2018 14:44:50 -0700 (PDT) To: bug-gnu-emacs@gnu.org From: Hong Xu Subject: 26.0.91; No documentation for key and value in the function passed to `map-keymap' Message-ID: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> Date: Sun, 25 Mar 2018 14:44:48 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="yGfTyMDSW7Y7ezPQceKlO26SLho6IuOCf" X-Zoho-Virus-Status: 1 X-ZohoMailClient: External X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --yGfTyMDSW7Y7ezPQceKlO26SLho6IuOCf Content-Type: multipart/mixed; boundary="RsUoTAeFmhc4poQpmwm3HytPjRW65Azzd"; protected-headers="v1" From: Hong Xu To: bug-gnu-emacs@gnu.org Message-ID: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> Subject: 26.0.91; No documentation for key and value in the function passed to `map-keymap' --RsUoTAeFmhc4poQpmwm3HytPjRW65Azzd Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable A callback function should be passed to `map-keymap'. However, the description of the callback function seems to be missing (undocumented). For example, the value does not seems to always be a function. It is sometimes an alist, sometimes a more complicated list. I think this might have never been documented. If it is documented, it would be greatly appreciated if a pointer to the actual documentation can be added to the document of `map-keymap'. Hong --RsUoTAeFmhc4poQpmwm3HytPjRW65Azzd-- --yGfTyMDSW7Y7ezPQceKlO26SLho6IuOCf Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEExhpJYaW1K1QSOB5eJmx9M4IvhHgFAlq4GFAACgkQJmx9M4Iv hHirxBAA1StoqFW2QQocmM/hrRh77lr6rdDuEiyI8yaxXGosHaFiIAo/QZXHPUkJ 8JKtH0ixG6qGMHuoDMLrzHT0AohvNRNWaAjnSmKHblqgSXBPr89vtMH7J10urZp0 jUYsHwXnyNwLWd5Cm+lJU9nT87G9oVpHYVvSec6HMATAtfg1JU7F8NOY5Zq2P6Ns 5ID1oBab2AJbC4fkQ76WGwbGOGFEGdI+4ZPfB9hHcfudvtAwYs7c8AOnuiJWn02g FTujZAnpr0r5EQncJ6BK9+Ede4bKNotEMzYBYvL3yuWED5iE1tjwvbg3DstfNwSh nm2wuVIT7W7mQfU2A359E5vi7x2KwyoV1YO5rsvzRV2/Vs4yHPJOtllGzrXPAARG 4aSPRnjqUkzwLxZoQ8Xn/IAXtjWJtwipWxyhZd7o4PI+fOe4zcb16bfpLSVROqhF HvfwoBtuX0pMb1e3mNySdYYJ/lIzdjo2o9lEt72z1OqE0ElKvg9cz6dJm55OZMoI OdaZOiFpWC/ra+uJWYhRvoLYgfYEIeYukDgZiavn8jTGCPWXVURSBtvkYhXKeVWu ALlUmLga3/tCWsN2W0zsEPd8Zz6XIPHrBZar5dFEmDeJqpkjRGLVuZ0QkhgLS5T/ 9nezlfZknvx0GvB4nzSbUynTkWj6YlM/z97nHYIQIjHu/ogI2ik= =7w6w -----END PGP SIGNATURE----- --yGfTyMDSW7Y7ezPQceKlO26SLho6IuOCf-- From debbugs-submit-bounces@debbugs.gnu.org Tue Mar 27 00:15:51 2018 Received: (at 30958) by debbugs.gnu.org; 27 Mar 2018 04:15:51 +0000 Received: from localhost ([127.0.0.1]:55021 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0g1W-0004Ky-RG for submit@debbugs.gnu.org; Tue, 27 Mar 2018 00:15:51 -0400 Received: from aserp2130.oracle.com ([141.146.126.79]:46526) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0g1U-0004Kk-Fh for 30958@debbugs.gnu.org; Tue, 27 Mar 2018 00:15:49 -0400 Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w2R44HVU119510; Tue, 27 Mar 2018 04:15:42 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=gNRA2FvlTapUpxJ5TSqv6wS5iYHNCML99M1dUXLGxNI=; b=nCcyPLevzRrmp/1C1Q9DGRks+Zclug/WI2ffw0EJmBsIUqsP956JrLz4ORXnD0zsd3rD 6JtfTgGb5KuO2XQgucoLYVHTAgtOS1SnZIOu7oUnvyvfT+lING/OXZx8B9AVaQ2U1NRq Bc/qGYgAd+tYTtYZ7ztah0F0KQjxN4VK7n5DwIWQH+AP8caW2/f8QeXAiVEs1yHWaNCH hlxhjrjhI0IfO4fIoFbn0L0yNSx/txtLNGjxsKHKc7eXXyRj3wnHgKzrnsg8tQOi06Ce YMFyChdjgb2kefiTw2Qs6XGNUafa4+8cByFcxGsCn0xaTzAJUyGUypFCesoSUUnL3X36 Tg== Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp2130.oracle.com with ESMTP id 2gyek4017q-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 27 Mar 2018 04:15:42 +0000 Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w2R4Feo0029982 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 27 Mar 2018 04:15:41 GMT Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w2R4Fedj021963; Tue, 27 Mar 2018 04:15:40 GMT MIME-Version: 1.0 Message-ID: Date: Mon, 26 Mar 2018 21:15:38 -0700 (PDT) From: Drew Adams To: Hong Xu , 30958@debbugs.gnu.org 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> In-Reply-To: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4666.0 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8844 signatures=668695 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=990 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1803270044 X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 30958 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) > A callback function should be passed to `map-keymap'. However, > the description of the callback function seems to be missing > (undocumented). For example, the value does not seems to always be a > function. It is sometimes an alist, sometimes a more complicated list. >=20 > I think this might have never been documented. If it is documented, it > would be greatly appreciated if a pointer to the actual documentation > can be added to the document of `map-keymap'. (If this report is clear to others then don't worry about it, but it's not clear to me.) I wouldn't call the FUNCTION arg a "callback" function, but it's the only function that is passed, AFAIK, so I guess that's the one you mean. What makes you think it doesn't always need to be a function? Grepping the Emacs Lisp files, I don't see any cases where it is not a function (or where the KEYMAP arg is a function). FUNCTION is described pretty well in the doc, I think - the args it is passed are described. If you instead meant the KEYMAP arg (whose value is not a function, AFAIK), then there is a whole section of the Elisp manual devoted do describing that, including the various forms a keymap can take (e.g. particular kinds of alists). See https://www.gnu.org/software/emacs/manual/html_node/elisp/Keymaps.html and its child nodes. (I'm probably missing something that you meant. If so, please ignore.) From debbugs-submit-bounces@debbugs.gnu.org Tue Mar 27 04:07:46 2018 Received: (at 30958) by debbugs.gnu.org; 27 Mar 2018 08:07:46 +0000 Received: from localhost ([127.0.0.1]:55118 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0jdy-0001O3-BE for submit@debbugs.gnu.org; Tue, 27 Mar 2018 04:07:46 -0400 Received: from sender-of-o52.zoho.com ([135.84.80.217]:21326) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0jdv-0001Nt-Tn for 30958@debbugs.gnu.org; Tue, 27 Mar 2018 04:07:44 -0400 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 152213805830966.70242756906498; Tue, 27 Mar 2018 01:07:38 -0700 (PDT) Subject: Re: bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap' To: Drew Adams , 30958@debbugs.gnu.org References: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> From: Hong Xu Message-ID: Date: Tue, 27 Mar 2018 01:07:33 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 MIME-Version: 1.0 In-Reply-To: Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="9uaEIjt0OWh08OnEJd5KIL4hCKzaLsyV5" X-Zoho-Virus-Status: 1 X-ZohoMailClient: External X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 30958 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --9uaEIjt0OWh08OnEJd5KIL4hCKzaLsyV5 Content-Type: multipart/mixed; boundary="rbQGhaaGLARx7pUFMwFKBFiR8rPEMbQtU"; protected-headers="v1" From: Hong Xu To: Drew Adams , 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> In-Reply-To: --rbQGhaaGLARx7pUFMwFKBFiR8rPEMbQtU Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable On 03/26/2018 09:15 PM, Drew Adams wrote: >> A callback function should be passed to `map-keymap'. However, >> the description of the callback function seems to be missing >> (undocumented). For example, the value does not seems to always be a >> function. It is sometimes an alist, sometimes a more complicated list.= >> >> I think this might have never been documented. If it is documented, it= >> would be greatly appreciated if a pointer to the actual documentation >> can be added to the document of `map-keymap'. >=20 > (If this report is clear to others then don't worry about it, > but it's not clear to me.) >=20 > I wouldn't call the FUNCTION arg a "callback" function, but > it's the only function that is passed, AFAIK, so I guess > that's the one you mean. >=20 > What makes you think it doesn't always need to be a function? > Grepping the Emacs Lisp files, I don't see any cases where it > is not a function (or where the KEYMAP arg is a function). >=20 > FUNCTION is described pretty well in the doc, I think - the > args it is passed are described. >=20 > If you instead meant the KEYMAP arg (whose value is not a > function, AFAIK), then there is a whole section of the Elisp > manual devoted do describing that, including the various > forms a keymap can take (e.g. particular kinds of alists). >=20 > See https://www.gnu.org/software/emacs/manual/html_node/elisp/Keymaps.h= tml > and its child nodes. >=20 > (I'm probably missing something that you meant. If so, > please ignore.) >=20 Thanks for your reply and sorry for the confusion -- I wrote those in a hurry. What is confusing in the current document, IMO, is the VALUE arg of the FUNCTION arg of `map-keymap'. The document reads: "It passes two arguments, the event type and the value of the binding." However, I searched the document, and could not find any useful information regarding the value of the binding. According to my own experiments, in most cases, it is a function, but sometimes it is an alist, or keymap, or of other types. I guess this may be obvious to many of you and may be documented somewhere, but a link to those is somehow missing; or it may be completely undocumented. I would appreciate it if the value of the binding is well documented (or a link to it is added). --rbQGhaaGLARx7pUFMwFKBFiR8rPEMbQtU-- --9uaEIjt0OWh08OnEJd5KIL4hCKzaLsyV5 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEExhpJYaW1K1QSOB5eJmx9M4IvhHgFAlq5+8kACgkQJmx9M4Iv hHjFFhAAvqhi9kiqefmsLJqbrbW/XKcsXolhjY8kX56GRjRmuv4a0q3+BLKf4meK lufNq48ZQidCM0sbkPH4ZEn8qvH0Z7NQAAIKiwWCIzWCRqWCnPW1yNWTpAaa5zYN WRmlEBODJi09vQ65Wd/YEu/zDkW1hYMhuHH7E5wNriMXFV4X8xnTR9G7Jpj2UWhb NIzrnIpeeZM/ZWCppHKxHZ5LvrkkRN4MCMStYSzU71cQ/0xC+VGowmPYt+jqyUFD 6xlxZGqlnokO69QkELpXWum7cwI1v/q4lgbFrnH3qxA3FscVcf8Fm6ZPe5LCZmpn hKW82hvhhYUCaXFXgfAjWec00ne9tXsy6iTGxUIS4Z8CWT9tYPfZ8S3N7TBjApni hUNcC2URMJfRg8A3kxVeIg2+7NscankA2ciIvu6zTq2buOz/5m5Bu2mBgPPZ2ZW/ IvVuNYhs23fXDNqutethtowONSfDguktbSO4sZ6sDmxthD4wn4L4mZqTdzyEuGNC 0l4fN5H65b5ZVTuEEMvR0Ylhwui8IzbSYwY7KVJsDOUeWwvVbljfZNP6oGRpav8q p8kGtW0/HYwcGsoodLtmSvIyr5BA4aMC0qW78oox+1FDnzEkpchDimvFhNi28KcX oI1GVkqsZjXrPP1WLL0D/5OvLW/27zT0eyrVrMdMBAWV++sjgZU= =+3+c -----END PGP SIGNATURE----- --9uaEIjt0OWh08OnEJd5KIL4hCKzaLsyV5-- From debbugs-submit-bounces@debbugs.gnu.org Tue Mar 27 05:35:30 2018 Received: (at 30958) by debbugs.gnu.org; 27 Mar 2018 09:35:30 +0000 Received: from localhost ([127.0.0.1]:55205 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0l0r-0007MK-TD for submit@debbugs.gnu.org; Tue, 27 Mar 2018 05:35:30 -0400 Received: from mx2.suse.de ([195.135.220.15]:45803) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0l0q-0007M7-8r for 30958@debbugs.gnu.org; Tue, 27 Mar 2018 05:35:28 -0400 X-Virus-Scanned: by amavisd-new at test-mx.suse.de Received: from relay2.suse.de (charybdis-ext.suse.de [195.135.220.254]) by mx2.suse.de (Postfix) with ESMTP id 79A48AFFE; Tue, 27 Mar 2018 09:35:21 +0000 (UTC) From: Andreas Schwab To: Hong Xu 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> X-Yow: I FORGOT to do the DISHES!! Date: Tue, 27 Mar 2018 11:35:20 +0200 In-Reply-To: (Hong Xu's message of "Tue, 27 Mar 2018 01:07:33 -0700") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.91 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 30958 Cc: 30958@debbugs.gnu.org, Drew Adams X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) On Mär 27 2018, Hong Xu 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. Andreas. -- Andreas Schwab, SUSE Labs, schwab@suse.de GPG Key fingerprint = 0196 BAD8 1CE9 1970 F4BE 1748 E4D4 88E3 0EEA B9D7 "And now for something completely different." From debbugs-submit-bounces@debbugs.gnu.org Tue Mar 27 10:27:44 2018 Received: (at 30958) by debbugs.gnu.org; 27 Mar 2018 14:27:44 +0000 Received: from localhost ([127.0.0.1]:56097 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0pZg-0007rh-0c for submit@debbugs.gnu.org; Tue, 27 Mar 2018 10:27:44 -0400 Received: from aserp2130.oracle.com ([141.146.126.79]:54176) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f0pZe-0007rU-0R for 30958@debbugs.gnu.org; Tue, 27 Mar 2018 10:27:42 -0400 Received: from pps.filterd (aserp2130.oracle.com [127.0.0.1]) by aserp2130.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w2RE4LGa175035; Tue, 27 Mar 2018 14:27:35 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=1RDNhBxAqZVDcJSZ/aagKrJLR3egA/5alDOoNsCU/Pc=; b=NX8tvFc/pICxZOaNlPwRmsHlto3PTicjUxxUOcYDUc1s+/f2CGXh8pR43zZucDOXoOeh T9N9yCjkGaclF+p7YFwZejdPquGgy76mQhSXp+XdiVNk1bfo2sPaB4pZnJZBxLCZam3U MqA6Mlc+d2GeMZ0fk8F+lWa847bgr0Ko1tDixIpjYKrLF4PRtfHLD7d68y5Lahwn4XlT qSzANO5YHeKMZL9RfiAnsRXujzIO15u/jy5dv6dQ98uQFTSX8kBNnYbVbhR3kZio2uMY rLcweJBh65Uvs6Tr3EFud/J14jIAPkaNXXHCX6YSFnYckzem//1K0GLrWHv37R0IA6Cq OQ== Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp2130.oracle.com with ESMTP id 2gyqc8g53j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 27 Mar 2018 14:27:35 +0000 Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id w2RERXJ0002894 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 27 Mar 2018 14:27:34 GMT Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w2RERW5e025361; Tue, 27 Mar 2018 14:27:32 GMT MIME-Version: 1.0 Message-ID: <2e495171-34f8-436e-9fc5-334bd93fde00@default> Date: Tue, 27 Mar 2018 07:27:31 -0700 (PDT) From: Drew Adams To: Andreas Schwab , Hong Xu 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> In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4666.0 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8844 signatures=668695 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=991 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1803270143 X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 30958 Cc: 30958@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) > > However, I searched the document, and could not find any useful > > information regarding the value of the binding. >=20 > 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. From debbugs-submit-bounces@debbugs.gnu.org Tue Mar 27 14:24:59 2018 Received: (at 30958) by debbugs.gnu.org; 27 Mar 2018 18:24:59 +0000 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 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 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) Subject: Re: bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap' To: Drew Adams , Andreas Schwab References: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> <2e495171-34f8-436e-9fc5-334bd93fde00@default> From: Hong Xu Message-ID: Date: Tue, 27 Mar 2018 10:39:09 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 MIME-Version: 1.0 In-Reply-To: <2e495171-34f8-436e-9fc5-334bd93fde00@default> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="t15etnqqyDrptYTMZVWm5UWhbfGnob2T7" X-Zoho-Virus-Status: 1 X-ZohoMailClient: External X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 30958 Cc: 30958@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) 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-- From debbugs-submit-bounces@debbugs.gnu.org Sat Oct 23 14:03:39 2021 Received: (at 30958) by debbugs.gnu.org; 23 Oct 2021 18:03:39 +0000 Received: from localhost ([127.0.0.1]:37171 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meLMm-0005Mw-3Q for submit@debbugs.gnu.org; Sat, 23 Oct 2021 14:03:39 -0400 Received: from mail-pj1-f48.google.com ([209.85.216.48]:51096) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meLMi-0005MV-3X for 30958@debbugs.gnu.org; Sat, 23 Oct 2021 14:03:32 -0400 Received: by mail-pj1-f48.google.com with SMTP id gn3so5192533pjb.0 for <30958@debbugs.gnu.org>; Sat, 23 Oct 2021 11:03:32 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:user-agent :mime-version:date:message-id:subject:to:cc; bh=jxrTpwmF6agT8f6HSKQnyKUtU1C8Np3H5pgEk3+cFn8=; b=1YIXN7ZOXErTOJFAK6b1pUWu6b/1kg+ZOrb9KM410dOJ/7rsH37MPHVTWYFW9SVlpv Jm7TtSRfmk1XOzjiPmDRnqL2nkoHFFu0NiWIkzeBKh+jonrXLfE+7VgspDPS1zB8gRhF UfQ5DF3+ih9uhYdptZ3/3FtX3DTRG8I8A7F0RBjX4G1Gj8AU8aLqAlxDdTwSQRuBUyZi zLOyj6QF7de/G2kMSoYgPRM6JYti7LEf1uXhgBm4hb8TxzSjs7EiO+dosKefztPBzzYY SoF2tpZ7rApwAVXSjwcioTzPxcHHG+3+IkKu1FS+tPYfG0N6s016yZaw0FFE0EtETTk5 NbZw== X-Gm-Message-State: AOAM530H/kswfZ8kz7kreAPxPpNEd0RsOI3cjrwvY5WHOhL5F1AkEIv/ gptGvRJ4QZAfdI3RBoANJCLQP/Im3XsDfzmnSxI= X-Google-Smtp-Source: ABdhPJyFNvSvNALa+qUlAU+/qi3p9qc9X45MrMAN1AuBFCxkf9vuypAKIDx9vfyagmUNVI3S4U2Um9oSjEcr0ZhVxj0= X-Received: by 2002:a17:902:b691:b029:12d:2b6:d116 with SMTP id c17-20020a170902b691b029012d02b6d116mr6448228pls.71.1635012206516; Sat, 23 Oct 2021 11:03:26 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 23 Oct 2021 11:03:26 -0700 From: Stefan Kangas In-Reply-To: (Hong Xu's message of "Tue, 27 Mar 2018 10:39:09 -0700") References: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> <2e495171-34f8-436e-9fc5-334bd93fde00@default> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Date: Sat, 23 Oct 2021 11:03:26 -0700 Message-ID: Subject: Re: bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap' To: Hong Xu Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 30958 Cc: Andreas Schwab , 30958@debbugs.gnu.org, Drew Adams X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) Hong Xu writes: > 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. The docstring of `map-keymap' says: Call FUNCTION once for each event binding in KEYMAP. FUNCTION is called with two arguments: the event that is bound, and the definition it is bound to. The event may be a character range. A keymap is fundamentally either a list or a char table with mappings from events to a definition. The event could be e.g. a key sequence, and the definitions might be commands or other things. I find "the event that is bound" to be clear enough, in the sense that you know what to look for in the manual. I also find "the definition it is bound to" clear in the same sense. I don't see what to add to make this any clearer, without pulling in the entire reference manual worth of stuff to explain all possible types of values. IOW, I think the answer here is that to use this particular function, you cannot just read the docstring, you must study the info node `(elisp) Keymaps' in detail. I don't see any way around that. So maybe you are right, but maybe also there is just not much we can do about it. Or there is some way to explain this that none of us have seen so far. Perhaps you have a suggestion for what we could add here? From debbugs-submit-bounces@debbugs.gnu.org Sat Oct 23 14:03:31 2021 Received: (at control) by debbugs.gnu.org; 23 Oct 2021 18:03:31 +0000 Received: from localhost ([127.0.0.1]:37168 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meLMg-0005Mf-VH for submit@debbugs.gnu.org; Sat, 23 Oct 2021 14:03:31 -0400 Received: from mail-pf1-f182.google.com ([209.85.210.182]:33347) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meLMf-0005MP-HV for control@debbugs.gnu.org; Sat, 23 Oct 2021 14:03:29 -0400 Received: by mail-pf1-f182.google.com with SMTP id t184so6638636pfd.0 for ; Sat, 23 Oct 2021 11:03:29 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:mime-version:date:message-id:subject:to; bh=3YXtjHUEm+gFTlhOky/6nUReHBMaSw/UJxG4adVOCIY=; b=cc91TjXupoWfMucnWhabJ24uJqcX5MtiHk7UZUgkG/DTTldht5BLFTCZcxX6Ly/qY+ fcgc2wA8IKSK4F777+P9qDGgf+A23NkQaDiQ7MTUbT1sKQOnjraR/ohPY4dFumpenhUt lAQylYh0JmW/bPXxMzpX9YIdPJRSQSStixutdQ4q2ObY8eBGERswcIFQdhgGvU72+6XP 9ynxHOLHUZj7L2jFiyU/lougvM7w8POpx8QPUcO6TMjpjrzRPHCVQgN485P1+/FYjAQf PFFMPLYXCHBG1NMqA+CbGvN1fhF5oxIrIRrj/qkR4BiZiC4ZQyV+qsc82aYa4B5Mm05H yR2A== X-Gm-Message-State: AOAM532BYPpneQUl38EFq2/0Kyx7xFCylCPrq06qAAEdRtqqmkDKQau2 PCgc/MlS9+9rtVomeoC/I8CWZSRHTpYybzp8NqTT3D3Uj3o= X-Google-Smtp-Source: ABdhPJyqGl26nKCS1YgcfT+0R9hcTOH7YbqUWjBUYuTt6Tfh5EuuLVvg/cubZBCFXkcN4QM3UKPIntWM7gJBt6ZF7U0= X-Received: by 2002:a63:330f:: with SMTP id z15mr2411196pgz.42.1635012203621; Sat, 23 Oct 2021 11:03:23 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 23 Oct 2021 11:03:23 -0700 From: Stefan Kangas MIME-Version: 1.0 Date: Sat, 23 Oct 2021 11:03:23 -0700 Message-ID: Subject: control message for bug #30958 To: control@debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) tags 30958 + moreinfo quit From debbugs-submit-bounces@debbugs.gnu.org Sat Oct 23 15:04:00 2021 Received: (at 30958) by debbugs.gnu.org; 23 Oct 2021 19:04:00 +0000 Received: from localhost ([127.0.0.1]:37301 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meMJE-0002wi-BN for submit@debbugs.gnu.org; Sat, 23 Oct 2021 15:04:00 -0400 Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:47166) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meMJA-0002wU-91 for 30958@debbugs.gnu.org; Sat, 23 Oct 2021 15:03:58 -0400 Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 19NEPD3D008364; Sat, 23 Oct 2021 19:03:55 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=TrbBMXxZVqsAz6pQ1L3dGPOjmgh4CISgEWQPcLeKbX8=; b=gNXvSlqaOTmutBxAFNAVLEZ7vlH4ZG0CP1ze0XR3WcwEgz1YPsxEuVfHDlGl7mAvGwf7 e5SQlFO7lT2e3nYPyLhnxqbi0TqI7hnVxLz5/+DdJGaW8NTaxeMWSdL06zWiFwvsDxDc QOxjh07tUgBa714PpNCBJZuqG2Kt/rC+Qy2T1uvhedaeTpqpXTycb8Pk6p6BYKiBsDmG tiNn0gKmQikdpfs7MWQRfpJ+HwkuwKmigc/KkKPRJkZHxU1o9VqMQQTpd5QpOVZ32bh/ dlW3ATIvl9RTvdO0KZZYmLwN4yNiy2w6+WLHHKaE3UiFBv60+MKi0GhM8zarhvcjxAhW WQ== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by mx0b-00069f02.pphosted.com with ESMTP id 3bva0tsr08-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 23 Oct 2021 19:03:55 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 19NJ1lFf175891; Sat, 23 Oct 2021 19:03:54 GMT Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2172.outbound.protection.outlook.com [104.47.55.172]) by userp3030.oracle.com with ESMTP id 3bv7grsbr3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 23 Oct 2021 19:03:54 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=WXFly90zZxukoOvJhwr6HhEw1J6HiBoi+DT+oEBbUMX0jBhfYAgYZRAcslhJk4cwnTHDDhtCMAPF8/kgnAPdQhk8ZjeNs37aODnmw5rjX+RMai2O64XQzPnc+i7lMWMGEjHtxj5nL3pfblIgl4XGeWIcymXjOwQkRmdO5HS3qxnsGbB6FXrjvSNDMxFeK8W4YjlcmOZpnczc/Aj57zMm2y0fvmbGcDfge3+rIDIZ/d9syeaHJdABoKWekqVjugWQqkBNByH/vOUxM6ChsUj4/oYPsxkokMqmhMcdts71shFmUhPZv2OI5BJxuoB3OPYtnjLU+rfaBOpvlhN73NsG/Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=TrbBMXxZVqsAz6pQ1L3dGPOjmgh4CISgEWQPcLeKbX8=; b=SolVptkQPJKHgIYJVOWpidsS5QHEgTwho+rBiWUtXR6E0JG6PIGIJvJZ7+I3NIGihMvyJSUHg2xMl1AHF1Xznmk9i1ozAqoadtC1XDkf8wMzWfcxUD1erIKZCnYnJ+V/iEZEn/hLQNLioX0XFN//nQl3SJYVb5tMW+Nw+fgfFQo9wcjIsu9fMRSfku4NwJ1tWs/jrtOacmO4pGWboHkUlD8iw5NAg0Mp8KVikkUMvEslOn9KoluLDZZ7OrFIBjtQZeeT4A161IR7ytDFDdWihkupF/QwxtcaLa4g9sPD4fhA2cWOdJOQZP27I2cM61obK9V+wYlK32vqzs4If3ZdYQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=TrbBMXxZVqsAz6pQ1L3dGPOjmgh4CISgEWQPcLeKbX8=; b=eAhAaobjsUr5qf+JdZzzl54/itz1m2UXOwNWtaYEhJy8Kk5OBv78KD9fBzRfH0meni9j0LAMFMlTrQ1bWTTGKu/EuDd4WvZ2XyAopuI9nDiou2NpWJm7LrEgxzhoXVJSR8yKPHtG75nRcnsI8esb0R2x4Q4fvZnYluAEeGfxCME= Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by SJ0PR10MB4655.namprd10.prod.outlook.com (2603:10b6:a03:2df::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4628.18; Sat, 23 Oct 2021 19:03:52 +0000 Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::c0bc:7c3a:292f:8a82]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::c0bc:7c3a:292f:8a82%8]) with mapi id 15.20.4628.020; Sat, 23 Oct 2021 19:03:52 +0000 From: Drew Adams To: Stefan Kangas , Hong Xu Subject: RE: [External] : Re: bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap' Thread-Topic: [External] : Re: bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap' Thread-Index: AQHXyDhLRfcJpkYR4USmtXgQYalDWavg72XQ Date: Sat, 23 Oct 2021 19:03:52 +0000 Message-ID: References: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> <2e495171-34f8-436e-9fc5-334bd93fde00@default> In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: marxist.se; dkim=none (message not signed) header.d=none;marxist.se; dmarc=none action=none header.from=oracle.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: cb962f24-24d5-41a9-f7c8-08d99657daa5 x-ms-traffictypediagnostic: SJ0PR10MB4655: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: PDWAMy6sinhstgJXL5u88zX/Vx4bIo9SSgIdKnNcwN8zCeRE+0iy37tCaeh3Oviwv1fS4uUixhyFCRANYd2wggNutnvc/942FC/UZjkUF2nbCVwOxm3Sd/MaZH1fmsUUz8DFd69PJMqkWAc+lZPSg3gvtURqF5AQEMQS9k6B8FCs6x6HnY/GAMri0mekhu2TpI5puRHsfG1G2wm2N6dWAppOxSeVfp7VdILozzLrIyffTnmUvvA4j7lCldgnS3WCtWb/TmWZM5xmxWptr1VhlzLOV13Ptb2SPa5LplFYkqungcF+c3m/0GOgylRnL66w+BWX0kUurA2Mes6p7iIaoYpqZxoYup1MGKMKp3T915b5KwdT3U6RM4aZKaTJypsDiBDzx1DKgE1M7x5Ao5Fc46IbawjsSnuI7KeDQjELQINVW5e2Y39xcMIgioU8IemzY3TLRydvTdhVE0XOgevFnSapFZh1dsOG6AaRMh8tvHkaTq7k9E3+a7zrBOITpxeDTOg2jIJlcWbtfJoqMPBwyliUZa3kbGod24A2sRh5mE54VC+mbrl5BZVlIXkLQIZONAExBkqqZAaIDdwcKs0d/oSvlfKV3Xx4K4sKnPjTHducQPXRilb7IcSaFGqoQ+Zp6pio+t5M+gcyVuVeQeBu90NuazPfkEZuUHQ1bXsqK4kv9FfOLKbtjKxNsupBYTJSnZepvgQS/HVC/PBsM8TxEsjOn0GfI9GPbKwpb1btLtE= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(508600001)(122000001)(83380400001)(52536014)(6506007)(26005)(4326008)(38100700002)(8676002)(8936002)(44832011)(9686003)(7696005)(5660300002)(71200400001)(33656002)(186003)(316002)(66946007)(38070700005)(55016002)(66476007)(66446008)(66556008)(4744005)(2906002)(76116006)(86362001)(110136005)(64756008)(54906003)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?utf-8?B?UHdiMGNkbjJUTkhpYzloSTZHTkdpS1hWV2gxeVlvcDh3M0h0ZFA1TDVRdlI2?= =?utf-8?B?S3FnRjFaU0R6SG5GK1FOY3lBOUVQeDlZeHR1ajh5ZnBMUDV6cnBJK01lZGpx?= =?utf-8?B?WERrSWFmVnBSVjVLRzgrL3F6MzU5M3dnUmdmNXlvL09QTjNYSHI3bWFFOU8v?= =?utf-8?B?bGV0S2U0SDVkTUZOcTdweWhRU0ZlSy92Ymg1TnVVM3c2TnRTa3owcE5ldmVm?= =?utf-8?B?dVk4UWQ3ZVl5NC9aVW9UU3pCQk5RUDl3YmJDMDR0Y2ZmNU1OL2NCRXEreXdJ?= =?utf-8?B?U2dPNC96SURTNkcrSkRXUzdwZXJ1OGYwWndySzBvV1hWTm5jR1Bwc2pITVNk?= =?utf-8?B?dzA5djI2WDRjREJTNXByWTlPa0R1bzh6d005YXJTWlhNcEMzcVVtaldXRW1K?= =?utf-8?B?ZTJIVFhWR3ZlRkdVNndtZG85MWNXUmYvZ1lDUDczTXFFblZjN3BMUjBXbFhr?= =?utf-8?B?dmZvbzlhTXdIUW1PZTVURHkveUtLSG9zZXZ6VzF6YkZCeE9SUENwdGRvOEpo?= =?utf-8?B?bGdCemM4MUc1WjRONm9Fc0UxWEdQSXgyUHZrcTRxS1h1aEdNUitLUHlHRm16?= =?utf-8?B?NzZEdld5VWpLZnRHdTRZNUNJb2w3Tzc1SmJFNFN2Q1FhcEtXRjVZK2g3bG1p?= =?utf-8?B?QzF4SVpqRjJtNjl1cHlSUEIwVXNDakRwZGxJaVhDT0NRRnhFWkxoZmxkeUZk?= =?utf-8?B?VEtpNVlNTW9uTnkwNkxvcG85aHpra3Y4TmVjRk1vMkdac3hmd1ZGaXk1WitG?= =?utf-8?B?bXVLbmVOd1VYTWJHRkx2Nlc4MVl0TG40dy8rT1dVNXFoWUpJNDdqRHFXOElT?= =?utf-8?B?L242OE10ZmpRTFhzanE0anZrYTlzTXI2aFJoQmRGa01KdVpWTTg1czhFRUhC?= =?utf-8?B?UGhOWEN3MDQzVDFDenJaQTQySWZlcnZzelRGSTNvUHhoN004QnpPbU91MDI1?= =?utf-8?B?NDU2Vy9jWE0wbTRWVDM4K24rUDR5aXVuRHptK1RRUEdjMk5IOWROT0puc0M4?= =?utf-8?B?QklxYUxTcnc3S2JqNElwWllSOUZjYTJTYUFuYjk3VFVIVDlKSDdMRWF3S05u?= =?utf-8?B?NlMzcHFnQ3lmK0N2R1F0bjM2N2MveG1nMUFBR2c5OTErQjViOVgxeVphY0xM?= =?utf-8?B?QUJCVFdiL0lQTU5BUHN5WnV0VU1ZcjlsMUNMSytiU1RhTGtzRFJSeGdLQXZR?= =?utf-8?B?V0Q1L3hmaDVGdHU3RGh3a3dQV2VMNWpzYlJ5eld2cFlaR0dhNTZNeXg2QVY5?= =?utf-8?B?UW5NNlhid1I2ZXowaFY2MlAzdVJxcTV4OTNhb2NjaUNIbXpXM3VOdkdXK0ds?= =?utf-8?B?M2FXOEtTaTlIbFVoRjJjNFowTHJEN1BVbnUwbFd2cDZJaExDUThCSExXK2dX?= =?utf-8?B?MjRiNFFBNC9qREY4Wk1mRWltUitOZFppRGdNVFFGUFhFVnRsRjZqOFdMRnV5?= =?utf-8?B?cVdFU3lzbS90WHlpWjhXMTdvQnNQNFdaNlNDSGJYSHFSOGZXblQrNkJVbmR3?= =?utf-8?B?eS84cE14ZldCY3FtbW5UZnoxNEx4MXJKQlNqQ0FES0lUTUhpMVQ3S3dlQ01M?= =?utf-8?B?WWt1bXUweHpVdy92MTRoMjNMODIvazNCL1lVcVE3Z0xIL2RPODJnNEpLVC8x?= =?utf-8?B?N0hSbW8vdUNnMjlwVVFNNUlGZ3k2cXcxcTV2TndMNk12czIrYmQyWVRvWDho?= =?utf-8?B?L2VHSHZJSVhEeWxxam5zWG1JdXpOV3daT25ZYWRiVld5VVNYSFpabUZ6dFMz?= =?utf-8?B?U0ZUTTZtVkhoUFNXajdVYTc1b3dwS2dPeVRRdThXMG5zS3Z6VFp2OXpnVWV2?= =?utf-8?B?TGYvdmQyeS9NTXZXSzVnRm5BSUVYcUtnS1NvTEo0RFBpRzQrcm1lbTFFdDl3?= =?utf-8?B?amxzMFhEQmJ2aGxrK2srMzJJUjFOV1lxSllpa29JeTZtMU1Na1NlRXptaGZk?= =?utf-8?B?NExtcHNybk9yTnZJbWJ3cEhnMzBveG9Kd0R2ZUU0N05YWndzQlhzSUpKeU9q?= =?utf-8?B?Tmtxcnlock9aTmJibXR0TDJLUEN2YTdiNm1scFIwRTRlR0F5Q3hmdnRpODdO?= =?utf-8?B?azFiakdxZ3psWTdmYW1KRzNpZTBRRGN3K3FZY2dtbGVjY3FMcVdJVWJVNjFi?= =?utf-8?B?MitsUGpFdzFWV3pTZzFUWktxYldMZGFpK090bjFzYTdTZmdyZ1JXYTV6RWlO?= =?utf-8?B?SlE9PQ==?= Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 MIME-Version: 1.0 X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: cb962f24-24d5-41a9-f7c8-08d99657daa5 X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Oct 2021 19:03:52.2962 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 2Fg3KJznCEEtyKmIi/0MGmCXsPl2vjx2edcavQlmfuwAcTeKEUL7WAVxa0bbN/2MHzJEueWzqYVWySaBcl4U7w== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR10MB4655 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10146 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 phishscore=0 adultscore=0 suspectscore=0 mlxscore=0 bulkscore=0 mlxlogscore=336 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2109230001 definitions=main-2110230122 X-Proofpoint-ORIG-GUID: 8g4lMAiPotgs0yXld9l1yDcLlJIUYxyi X-Proofpoint-GUID: 8g4lMAiPotgs0yXld9l1yDcLlJIUYxyi X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 30958 Cc: Andreas Schwab , "30958@debbugs.gnu.org" <30958@debbugs.gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) SSBhZ3JlZSB3aXRoIFN0ZWZhbiB0aGF0IHRoZSAoMSkgZG9jIGlzIGNsZWFyIGFzDQpmYXIgYXMg aXQgZ29lcywgKDIpIHRoZSBzZXQgb2YgcG9zc2libGUga2V5LWJpbmRpbmcNCnJlcHJlc2VudGF0 aW9ucyBpcyBsYXJnZSBhbmQgY29tcGxleCwgYW5kICgzKSB0bw0KdW5kZXJzdGFuZCB0aGlzIHN0 dWZmIHlvdSByZWFsbHkgbmVlZCB0byBjYXJlZnVsbHkNCnN0dWR5IHRoZSBjYXJlZnVsbHkgc3Bl Y2lmaWVkIGRvYyBpbiB0aGUgRWxpc3ANCm1hbnVhbCBmb3IgdGhpcy4NCg0KKFRoZXJlIGFyZSBz b21lIG90aGVyIGNvbXBsZXggYXJlYXMgbGlrZSB0aGlzLiAgT25lDQppcyBmb250LWxvY2sta2V5 d29yZHMgZm9ybXMuKQ0KDQpNeSBzdWdnZXN0aW9uIHdvdWxkIGJlIHRvIGhlbHAgdXNlcnMgYnkg cHJvdmlkaW5nDQphIG1pZGRsZSBncm91bmQgYmV0d2VlbiAoMSkgYSBjb3JyZWN0IGJ1dCBzcGFy c2UNCmFuZCBsaXR0bGUtZXhwbGFuYXRvcnkgZG9jIHN0cmluZyBhbmQgKDIpICJwdWxsaW5nDQpp biB0aGUgZW50aXJlIHJlZmVyZW5jZSBtYW51YWwgd29ydGggb2Ygc3R1ZmYgdG8NCmV4cGxhaW4g YWxsIHBvc3NpYmxlIHR5cGVzIG9mIHZhbHVlcyI6DQoNCkp1c3QgYWRkIGEgbGluayB0byB0aGUg cmVsZXZhbnQgc2VjdGlvbiBpbiB0aGUNCm1hbnVhbC4gIFRoYXQgd2F5LCBpbnN0ZWFkIG9mIGNs b3NpbmcgdGhlIGRvb3Igb24NCmFuIGludGVyZXN0ZWQgcmVhZGVyIG9mIHRoZSBkb2Mgc3RyaW5n LCB5b3Ugb3Blbg0KdGhlIGRvb3IgdG8gYSBmdWxsIHVuZGVyc3RhbmRpbmcuICBBbiB1bmludGVy ZXN0ZWQNCnJlYWRlciBtaWdodCBub3QgZm9sbG93IHRoZSBsaW5rIC0gbm8gaGFybSwgbm8gZm91 bC4NCg== From debbugs-submit-bounces@debbugs.gnu.org Sun Oct 24 02:26:31 2021 Received: (at 30958) by debbugs.gnu.org; 24 Oct 2021 06:26:31 +0000 Received: from localhost ([127.0.0.1]:37731 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meWxj-0001Ic-FK for submit@debbugs.gnu.org; Sun, 24 Oct 2021 02:26:31 -0400 Received: from mail-pf1-f173.google.com ([209.85.210.173]:39795) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meWxd-0001I5-9d for 30958@debbugs.gnu.org; Sun, 24 Oct 2021 02:26:28 -0400 Received: by mail-pf1-f173.google.com with SMTP id d9so7591997pfl.6 for <30958@debbugs.gnu.org>; Sat, 23 Oct 2021 23:26:25 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to:cc; bh=cSOcqvAuOwQSP54/FvEXPbdiMOCC8Atv234Rskc/+B0=; b=R+x2XPb2ezTdnWpNeYhRMqmWL6udP37ieyeLQgcPoez+Z2P1xsHb7lVKuow03SdY+V oKPiIOit137Y7LhgEHykyoMPs+6GgzjVuCRle19OV3kjTTA8j49TexvaS2jO8AHJ3yZa lZ+sm1n6+MOKB9/8IGNYENILPBNhwFxWCGLnOHRLUOV+G1YpbaCEvr8XK6MnRuPq4UTs sLCLHegjfO4qx0C9i9qym6+nZSMQPqJMAkbthFxKQp4g2rt16c08FBucDucJrtJ03DIr ch7IFWNfzHZWZPm4nYUS3rmoE/LRuWddigBel4L/Pu0eut3pN+CDBBNCCvZ0pg5C46IF 8qPg== X-Gm-Message-State: AOAM5338c0MfXzs9GeGJo9Cv9RUWu0TuAa+cvpGo3Qvxa5wrtftO1jYs Tw6WwFvMq+ermuUOO2hbiZrr3q5sGVSRoPqcavA= X-Google-Smtp-Source: ABdhPJxIhwHVmh2B/XyMp/YDc/151iuNnvPG9hv9+Wvce8frPEceTRbaeW5UzuXCoBPpcVpogX3JDAmT5m8VAigiPB4= X-Received: by 2002:a05:6a00:244d:b0:44d:c279:5155 with SMTP id d13-20020a056a00244d00b0044dc2795155mr10560969pfj.0.1635056779504; Sat, 23 Oct 2021 23:26:19 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 23 Oct 2021 23:26:18 -0700 From: Stefan Kangas In-Reply-To: References: <4f0b5f4f-74bd-5610-0cff-14da7ca90f39@topbug.net> <2e495171-34f8-436e-9fc5-334bd93fde00@default> MIME-Version: 1.0 Date: Sat, 23 Oct 2021 23:26:18 -0700 Message-ID: Subject: RE: [External] : Re: bug#30958: 26.0.91; No documentation for key and value in the function passed to `map-keymap' To: Drew Adams , Hong Xu Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: 30958 Cc: Andreas Schwab , 30958@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) close 30958 28.1 thanks Drew Adams writes: > Just add a link to the relevant section in the > manual. That way, instead of closing the door on > an interested reader of the doc string, you open > the door to a full understanding. An uninterested > reader might not follow the link - no harm, no foul. Yes, that seems like the best thing to do here. So I've now done that change on the emacs-28 branch (commit 0651c2d77b). I'm consequently closing this bug report. From unknown Thu Sep 11 04:20:51 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sun, 21 Nov 2021 12:24:07 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator