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#74999: [PATCH v4] Use `keymap*-set' over `global-set-key'/`define-key' in elisp intro Date: Fri, 27 Dec 2024 09:44:39 +0200 Message-ID: <868qs1y3h4.fsf@gnu.org> References: <86ed1uzwhw.fsf@gnu.org> <20241226214814.52057-1-hong@topbug.net> <87h66qp0c2.fsf@topbug.net> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38714"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 74999@debbugs.gnu.org To: Hong Xu Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Dec 27 08:45:17 2024 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 1tR524-0009r7-Sm for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 27 Dec 2024 08:45:17 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tR51v-0003k4-Ne; Fri, 27 Dec 2024 02:45:08 -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 1tR51q-0003gY-H7 for bug-gnu-emacs@gnu.org; Fri, 27 Dec 2024 02:45:03 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tR51q-0008W4-5Y for bug-gnu-emacs@gnu.org; Fri, 27 Dec 2024 02:45:02 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=References:In-Reply-To:From:Date:To:Subject; bh=7jzpQTEFjpTH/FnyzKwWgYY8dNaPEiR+emyWI2cQ2Dc=; b=E9rhNvG+IPmUookTa8Hc+DFnOESuaJU3zRG5Rj6KFs1ROkez/dJq9Fwr66sjzr7R86pKddl3jornkpLT7tpfG+CwxyJTAWllcIxwdEh7vXuSsV571KdRVgc4Wu3vc+qRJb6n7+rtT1L/TOpgoLaLpOd3ECQrNKTSFrL5WDTQHepYGtjDVPsJKZCMOlDkRWjTNiIc4F6WzRgngWZciQnXCCqtDwaY49hQ/PpYu+8UwgAdCvUCtYugf7iJHwnPy09ic3lVNW6T9bKmoaBgglWVHhfd/S20aXtW0FnMk/XitDTAjWAGhwYGrRUp3IaOtBWzp51EM3OrbSptzidNUHAatA==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tR51q-00010R-0C for bug-gnu-emacs@gnu.org; Fri, 27 Dec 2024 02:45: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: Fri, 27 Dec 2024 07:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 74999 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 74999-submit@debbugs.gnu.org id=B74999.17352854893834 (code B ref 74999); Fri, 27 Dec 2024 07:45:01 +0000 Original-Received: (at 74999) by debbugs.gnu.org; 27 Dec 2024 07:44:49 +0000 Original-Received: from localhost ([127.0.0.1]:44540 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tR51c-0000zl-Lj for submit@debbugs.gnu.org; Fri, 27 Dec 2024 02:44:48 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:56304) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tR51a-0000zW-DF for 74999@debbugs.gnu.org; Fri, 27 Dec 2024 02:44:47 -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 1tR51U-0008UQ-Hv; Fri, 27 Dec 2024 02:44:40 -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=7jzpQTEFjpTH/FnyzKwWgYY8dNaPEiR+emyWI2cQ2Dc=; b=LUbhiwwS0vlx VX1K/WX9uz8PTnZfSFLshvnZuLkyEoA0S35USb4kcEgp4lpMqItVVc7C1DGcM0TiQJWgxC1zBDvah DjuaObhL9G8vms5LE/iiVSSl3UZX2xBx+n0WyV8CVQbw5sqa5bHm9kGVz4MxvWD80GyqfEXOJqvWw d+AjW6QqWjkiSItYoiPEYIJ/CB1TokgoYIuggTehSIdPk79nXELvwvN83x6k/cgzysfefSl0YGqRj YdH9/rFb09uNduYauGlNPb6M3YBG+peQKSR70KAmgsBzjFk9JI+A9Jrcz3t0Wgga+6UgMfnXag25M Yg6HDBDfrKtzaL7ib2x5gQ==; In-Reply-To: <87h66qp0c2.fsf@topbug.net> (message from Hong Xu on Thu, 26 Dec 2024 14:05:01 -0800) 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:297807 Archived-At: > From: Hong Xu > Date: Thu, 26 Dec 2024 14:05:01 -0800 > > On 2024-12-26 Thu 13:46 GMT-08, Hong Xu wrote: > > > * doc/lispintro/emacs-lisp-intro.texi (Key Bindings): Since > > `global-set-key' and `define-key' are considered legacy, we encourage > > `keymap-global-set' and `keymap-set' now. > > --- > > <...> > > > > +@findex global-unset-key > > +Historically, keys are unbound globally using a lower-function, > > +@code{global-unset-key}, which is now considered legacy. Its key > > +binding format follows that of @code{global-set-key}. The above key > > +unbinding example can be rewritten as: > > +@smallexample > > +@group > > +;;; Unbind 'C-x f' > > +(global-unset-key "\C-xf") > > +@end group > > +@end smallexample > > + > > I'm thinking about dropping this paragraph, because `global-unset-key' > isn't commonly seen, and there's no point to over fill an introduction > with less used functions. Please advice. I wouldn't remove it. This manual is an extended tutorial of the Emacs Lisp language, so it doesn't necessarily include only the frequently-used functions. We must trust the author of this manual, who was a great expert in teaching Emacs Lisp, that his decision to include this function had a good reason.