From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: 29.0.60; keymap-local-set and keymap-global-set became less strict Date: Fri, 03 Feb 2023 14:11:56 +0200 Message-ID: <83mt5vuewj.fsf@gnu.org> References: <5876987d-2479-f512-5767-218c8c16a909@daniel-mendler.de> <875ycngyji.fsf@gnus.org> <87zg9zvzuc.fsf@gmail.com> <831qna3frm.fsf@gnu.org> <87mt5yogct.fsf@gmail.com> <83y1pi1wz4.fsf@gnu.org> <87ilgmodk4.fsf@gmail.com> <83mt5y1r5u.fsf@gnu.org> <87bkmdo8e4.fsf@gmail.com> <831qn91qo0.fsf@gnu.org> <137753af-777d-2da3-c111-7e2d414633f1@daniel-mendler.de> <83sffpze9h.fsf@gnu.org> <309dee07-e404-4f84-a839-8b99815376f8@daniel-mendler.de> <83mt5xz42d.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9945"; mail-complaints-to="usenet@ciao.gmane.io" Cc: mail@daniel-mendler.de, emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Feb 03 13:12:51 2023 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pNuvy-0002Sr-Pz for ged-emacs-devel@m.gmane-mx.org; Fri, 03 Feb 2023 13:12:50 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pNuvI-0001uN-Vs; Fri, 03 Feb 2023 07:12:09 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pNuvG-0001oS-WD for emacs-devel@gnu.org; Fri, 03 Feb 2023 07:12:07 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pNuvG-0004P5-2G; Fri, 03 Feb 2023 07:12:06 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=WSVlKPv5RPdNsYKTunPr3jmXUsXJE0oSxXYMbnq7GrU=; b=IlsC8/zDsPCepEH1BVd5 IjePAKr6AHBJw8JrlWMPawliJl/xaRmhth8TwGe7r/0OSVCNk1faXfhHkPSav1gi6a/cMsUZZGAVY cmilIYsMKmXW3V7NG/InnpkIKLXq0t9XDN1ZCWKBnu8+MRrxCtQZ/TQlD+fVG2dQ5oIIZG5Yt/muA aVAFZQe5gOY/KlrRQHmTceVUjKxy0rwGObPaM0KdtYkzmg9exb1obVG4GZ17DSrua/Mwh3y+qB9pp DYzzvGxwVl0b9sWtDYWzmxMg40ou2bpRXg1M/zj72NUe1RS8KOCFrxj70srOsGwdtRsj47h6sf42B boT83FVATC+GZQ==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pNuv2-00025C-3B; Fri, 03 Feb 2023 07:11:53 -0500 In-Reply-To: (message from Richard Stallman on Fri, 03 Feb 2023 04:56:49 -0500) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:302924 Archived-At: > From: Richard Stallman > Cc: emacs-devel@gnu.org > Date: Fri, 03 Feb 2023 04:56:49 -0500 > > > The advertised API wouldn't change. We don't expect anyone to use the > > additional argument in non-interactive invocation. We can use > > advertised-calling-convention declaration to hide that argument from > > documented interfaces. > > Why hide it? It's better to document it. > Occasionally, passing a nontrivial value for that argument is useful. We don't want Lisp programs to call this function pretending to be the user, because this function's raison d'être is to catch invalid key sequences. So we don't want to advertise that argument in the documentation. Of course, anyone who looks at the source will quickly discover the argument and will be able to take advantage of it. But we don't want that to be too easy. As for documenting it: I don't see the need, as its role is crystal clear once one looks at the code which uses it.