From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Panagiotis Koutsourakis Newsgroups: gmane.emacs.bugs Subject: bug#60859: [PATCH] Remove reference to the kbd function from documentation Date: Mon, 16 Jan 2023 13:15:22 +0200 Message-ID: <87pmbeivcl.fsf@panoramix.zarniwoop.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="35661"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) To: 60859@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Jan 16 13:04:29 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1pHODx-0008wN-FB for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 16 Jan 2023 13:04:27 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pHODd-0007E7-UW; Mon, 16 Jan 2023 07:04:05 -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 1pHODb-0007Dw-89 for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2023 07:04:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pHODa-0005nb-Uc for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2023 07:04:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pHODa-00063L-MP for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2023 07:04:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Panagiotis Koutsourakis Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Jan 2023 12:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 60859 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.167387059223207 (code B ref -1); Mon, 16 Jan 2023 12:04:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 16 Jan 2023 12:03:12 +0000 Original-Received: from localhost ([127.0.0.1]:60646 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHOCl-00062E-VY for submit@debbugs.gnu.org; Mon, 16 Jan 2023 07:03:12 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:37024) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHNSg-0002G3-4w for submit@debbugs.gnu.org; Mon, 16 Jan 2023 06:15:34 -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 1pHNSf-00073b-F6 for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2023 06:15:33 -0500 Original-Received: from wout4-smtp.messagingengine.com ([64.147.123.20]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pHNSa-0005ro-Sx for bug-gnu-emacs@gnu.org; Mon, 16 Jan 2023 06:15:33 -0500 Original-Received: from compute3.internal (compute3.nyi.internal [10.202.2.43]) by mailout.west.internal (Postfix) with ESMTP id 987BA32004E7 for ; Mon, 16 Jan 2023 06:15:25 -0500 (EST) Original-Received: from mailfrontend1 ([10.202.2.162]) by compute3.internal (MEProxy); Mon, 16 Jan 2023 06:15:25 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= slartibartfast.net; h=cc:content-type:date:date:from:from :in-reply-to:message-id:mime-version:reply-to:sender:subject :subject:to:to; s=fm1; t=1673867725; x=1673954125; bh=5EFXDkvq+g gpva0GX55yLE53RSmus5rNu6FRe8xyFkg=; b=mkkfelngwGhFwyPGxoYdCe2Uxr FksCq7BQcQM/USsli24yo48sjxyuvku+O3KBCZCvftxLXG9ruu1Bzf9nJWKMtqP/ KlID89or5l2iF5P27PzpIqPriK+2FZRik+RhNGx6Oj2ybLKunh9AHSpFV0+6v/C/ mtCKbPm42i77JtkX6oy4F65ghSMSjkIC+b4wK1zzeRsL+CKv/V7l62Zh1LFKcLO7 0fEbMSI4VxOzPTc+cNHuNjoXOu4Rm0GmEvDn6ttSTtl5D8h9rT+awUkQTRV1TTqG vfUshnoB10XmwvtYznO08aG/ebhGjrSm7TSAu8ehgNxxn05YpVFp9gnVsPCw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:date:feedback-id :feedback-id:from:from:in-reply-to:message-id:mime-version :reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1673867725; x= 1673954125; bh=5EFXDkvq+ggpva0GX55yLE53RSmus5rNu6FRe8xyFkg=; b=r s06/H8GyFyAwWcQV+XnVHV17dDJKSsvdhZ7Vl6CUDYA7ZMxR23pmIDfWguehFAvQ 705FKWG3tiNFMWv/XZJW94Y6Ia3brfzAvQFoVWAcp4jWSNZlt55mTeJWJ8R+lDXG gHX1yRq6nQFAj0qpG8c79tFOYS0HkrsHKYWcUXgUO/qmX8i6vfh+x+E4hpfNfKnV WX3GZOi7vtQzliY/l47ZgoCmv8wuy52j8CLmprKCR8N5LI6Nt2KjqM//wiXz5HmS RG2Cp/UtVFg61RKOHp5PR7xujoOoG/y0dlqfKYc6nZFAN88JJoL5j5uUgNuYNYx1 Sqtjg8owQhhF8TxOtcuWw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvhedruddtgedgvdehucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefhvffufffkfgggtgesmhdtreertd ertdenucfhrhhomheprfgrnhgrghhiohhtihhsucfmohhuthhsohhurhgrkhhishcuoehk uhhtshhurhgrkhesshhlrghrthhisggrrhhtfhgrshhtrdhnvghtqeenucggtffrrghtth gvrhhnpedvudeviefggeelgeffleelfffgjedttdegudejfeehieejvdehjedujefgudek ieenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehkuh htshhurhgrkhesshhlrghrthhisggrrhhtfhgrshhtrdhnvght X-ME-Proxy: Feedback-ID: iaac9463b:Fastmail Original-Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Mon, 16 Jan 2023 06:15:24 -0500 (EST) Received-SPF: pass client-ip=64.147.123.20; envelope-from=kutsurak@slartibartfast.net; helo=wout4-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Mon, 16 Jan 2023 07:03:10 -0500 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:253481 Archived-At: --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-Remove-reference-to-the-kbd-function-from-documentat.patch >From c0de146a194603a463147a819d96c9f7d0eb61e3 Mon Sep 17 00:00:00 2001 From: Panagiotis Koutsourakis Date: Mon, 16 Jan 2023 11:49:05 +0200 Subject: [PATCH] Remove reference to the kbd function from documentation --- doc/emacs/custom.texi | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 91df15a21d7..650a96f14b1 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -1887,12 +1887,8 @@ Init Rebinding you can specify them in your initialization file by writing Lisp code. @xref{Init File}, for a description of the initialization file. -@findex kbd - There are several ways to write a key binding using Lisp. The -simplest is to use the @code{kbd} function, which converts a textual -representation of a key sequence---similar to how we have written key -sequences in this manual---into a form that can be passed as an -argument to @code{keymap-global-set}. For example, here's how to bind + The simplest way to write a key binding using Lisp is to use the +@code{keymap-global-set} function. For example, here's how to bind @kbd{C-z} to the @code{shell} command (@pxref{Interactive Shell}): @example -- 2.39.0 --=-=-= Content-Type: text/plain Hi emacs devs, I am attaching a patch to the manual for emacs 29 that removes from the text a reference to the `kbd' function when creating a key binding in Lisp. The example that follows is correct (i.e. it works for me), but the explanation seems outdated. I think that this change qualifies as "small", but let me know if you think I need to assign copyright. -- Best regards, Panos. --=-=-=--