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.bugs Subject: bug#60859: [PATCH] Remove reference to the kbd function from documentation Date: Tue, 17 Jan 2023 19:32:34 +0200 Message-ID: <83lem12hjh.fsf@gnu.org> References: <87pmbeivcl.fsf@panoramix.zarniwoop.org> <83ilh64juj.fsf@gnu.org> <87o7qyo3nc.fsf@panoramix.zarniwoop.org> <83cz7e4dve.fsf@gnu.org> <87edrt6y4p.fsf@panoramix.zarniwoop.org> <875yd5ciqs.fsf@gmail.com> <87fsc9jg6p.fsf@panoramix.zarniwoop.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27452"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rpluim@gmail.com, 60859@debbugs.gnu.org To: Panagiotis Koutsourakis Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Jan 17 18:33:17 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 1pHppl-0006tM-83 for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 17 Jan 2023 18:33:17 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pHppZ-0005NR-Fu; Tue, 17 Jan 2023 12:33:06 -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 1pHppW-0005Jn-E4 for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2023 12:33: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 1pHppW-00085C-4L for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2023 12:33:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pHppW-0002V3-00 for bug-gnu-emacs@gnu.org; Tue, 17 Jan 2023 12:33:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 17 Jan 2023 17:33:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60859 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 60859-submit@debbugs.gnu.org id=B60859.16739767529571 (code B ref 60859); Tue, 17 Jan 2023 17:33:01 +0000 Original-Received: (at 60859) by debbugs.gnu.org; 17 Jan 2023 17:32:32 +0000 Original-Received: from localhost ([127.0.0.1]:38142 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHpp2-0002UJ-35 for submit@debbugs.gnu.org; Tue, 17 Jan 2023 12:32:32 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:50812) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pHpp0-0002U6-CT for 60859@debbugs.gnu.org; Tue, 17 Jan 2023 12:32:30 -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 1pHpou-00083v-Ns; Tue, 17 Jan 2023 12:32:24 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=7VjdgU3F+gZglpypbghytBNH5WXqoaNFf+7vuOScUos=; b=R9iorQ24xdaq U29B/s8qFMz0ucady9GhnM5KIATe9rdEHAAJ5vy+CCtP8j1koKq6pKt6c50gZc/YNpXGOnB+xWUlk GKiADGrK9jrKTHUXUn3AXf60PYm1owsuFSdFJtALvgIFagQV2k/rTYc5q999rTK60Qbrq0BNy0rJc FLTiJmmk6n6O/mpTAinuSFIbb9Y+6A/iKZNa+/adp7tNjuHiYJFuoKTNiuj+uto5U1GV0dPie+vJg eocZO79mGRY5rb/7MfI8GEYcrnU1I7KzIoSBs0PMOuscuc68CVqXFgDJ07Au++Ed10iNUJJSyhcB5 wtFO0FhFOtugWa1HgqG4xQ==; 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 1pHpot-0005b6-M1; Tue, 17 Jan 2023 12:32:23 -0500 In-Reply-To: <87fsc9jg6p.fsf@panoramix.zarniwoop.org> (message from Panagiotis Koutsourakis on Tue, 17 Jan 2023 18:09:50 +0200) 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:253567 Archived-At: > Cc: 60859@debbugs.gnu.org > From: Panagiotis Koutsourakis > Date: Tue, 17 Jan 2023 18:09:50 +0200 > > So, assuming that we want the documentation as a whole to be consistent, > I see two ways forward: either we eliminate or reduce the importance of > the old functions in the user manual, or we remove the effective > deprecation of the old functions in the emacs lisp reference manual and > expand on the use of 'kbd', 'global-set-key' and 'define-key'. > > What do you think? There's no need to generalize so much. Let's handle this specific issue, and then move on. For now, I don't want to remove references to 'kbd' from the manual, because many people still use it. So please accept that as the baseline, and let's find the best way to describe the new APIs as well.