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: The new keymap functions Date: Tue, 16 Nov 2021 16:08:26 +0200 Message-ID: <83lf1o19d1.fsf@gnu.org> References: <87zgq8sfw3.fsf@gnus.org> <8735o0mgj3.fsf@fastmail.fm> <87v90wi7hv.fsf@gnus.org> <43bf1f9b-55ec-67b6-1920-98179a5d6903@yandex.ru> <874k8dz7fq.fsf@gnus.org> <87czn08sqd.fsf@gnus.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="2797"; mail-complaints-to="usenet@ciao.gmane.io" Cc: joostkremers@fastmail.fm, emacs-devel@gnu.org, dgutov@yandex.ru To: Lars Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Nov 16 15:10:06 2021 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 1mmz9x-0000Vh-9F for ged-emacs-devel@m.gmane-mx.org; Tue, 16 Nov 2021 15:10:05 +0100 Original-Received: from localhost ([::1]:43892 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mmz9w-00058L-AD for ged-emacs-devel@m.gmane-mx.org; Tue, 16 Nov 2021 09:10:04 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:45872) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mmz8Y-0002pu-8j for emacs-devel@gnu.org; Tue, 16 Nov 2021 09:08:38 -0500 Original-Received: from [2001:470:142:3::e] (port=47920 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mmz8V-0000fs-F1; Tue, 16 Nov 2021 09:08:37 -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=NpCpFP5jW/8SZC6JF0Hg+PJVYGvRxFJXzilleLtTzTk=; b=aBU0QymxkuMM R05+MZFgBAQqmVH3QWpY4+8wtE+pV22MMGbfTx6zaYp28ka+kwhD16n3wcYnzbpcwqf6PzZmUWdOl l48+tbBPZL+WSvNLiEzEKXhTUSDRQGgM7IoNSq/GffSNLNceqMbjcjji2jsAflpo5RC87Ol48Df4N aNOYJTA8cIxJ3FEOeBuF8WiGnUZE+5Pw1xJh/A6saOl8JiAIcZ2L2dzE5EvRV630kOH8cq3SFGs3N V22wm3p4LXj/JSCEChCsofTXH1Fv0ujWhdrZazIjgyF+bq+t1CsQn8QfWgyuMaSA7TTdgEWOFabJb KpTe7i+2XFRiMKPUrna+gQ==; Original-Received: from [87.69.77.57] (port=3728 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 1mmz8V-0002De-3h; Tue, 16 Nov 2021 09:08:35 -0500 In-Reply-To: <87czn08sqd.fsf@gnus.org> (message from Lars Ingebrigtsen on Tue, 16 Nov 2021 08:28:10 +0100) 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" Xref: news.gmane.io gmane.emacs.devel:279559 Archived-At: > From: Lars Ingebrigtsen > Date: Tue, 16 Nov 2021 08:28:10 +0100 > Cc: Joost Kremers , emacs-devel@gnu.org > > Lars Ingebrigtsen writes: > > > After pushing the changes, you'll all have to say "make bootstrap" (or > > remove all the .elc files first) because of the changes to the syntax > > in `defvar-keymap'. > > I've now pushed the changes, but it doesn't look like you have to say > "make bootstrap" after all. The changes to the ELisp manual completely removed the documentation of global-set-key and other "legacy" functions, AFAICT. I don't think we can do that: the code which uses those will remain with us for the years to come, and Lisp programmers should be able to read and understand what these functions do. It is okay to say "don't use those in new code" (as you already did say), but we should put back the documentation of those few functions. There aren't too many of them, and their documentation is quite short, so it isn't a big deal to have them in the manual.