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 17:13:01 +0200 Message-ID: <83h7cc16de.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> <83lf1o19d1.fsf@gnu.org> <875yssrxfa.fsf@gnus.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25612"; 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 16:14:57 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 1mn0Ai-0006PX-UR for ged-emacs-devel@m.gmane-mx.org; Tue, 16 Nov 2021 16:14:57 +0100 Original-Received: from localhost ([::1]:53298 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mn0Ah-0002Sz-6G for ged-emacs-devel@m.gmane-mx.org; Tue, 16 Nov 2021 10:14:55 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:32952) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mn090-00011y-V5 for emacs-devel@gnu.org; Tue, 16 Nov 2021 10:13:10 -0500 Original-Received: from [2001:470:142:3::e] (port=50412 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 1mn090-0001qg-M5; Tue, 16 Nov 2021 10:13:10 -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=QbgcdmVw1Y313aQMnPJD4h0WHWwUrJS/GTzAnc/+H6M=; b=lO+qRMuETOuC tfFlFJ8x57Ci0O742404ZbDsUlGA5GT/gZD57nwrbkq4+wqUuJcq/sLBP+OWIN4XhgWPyC7aIXXfF VZEXqxXzOuDlo3uUDG1I9jkYE8ZOxFve3EKXXXQ2BNN0iZgPKuLH+0qL5xLdXgQsl+bquadql83aZ EifbwrYNQbjrPgmYt0CY7QCDCFut3skvD0L1Y82MOgTbfpthB4210oM+dwvYsBNWfNagNNIpOo9Fc BuCUMswWF/S4tzx6t/bE9cm7iCN7INRDGlVTHq8hp47EZZ78qckmJFFD3w8CXG903gz5tPEK+9yKl 1ELnNdjVBDT9p6XvjzB/Cw==; Original-Received: from [87.69.77.57] (port=3872 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 1mn090-00068e-40; Tue, 16 Nov 2021 10:13:10 -0500 In-Reply-To: <875yssrxfa.fsf@gnus.org> (message from Lars Ingebrigtsen on Tue, 16 Nov 2021 15:24:09 +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:279566 Archived-At: > From: Lars Ingebrigtsen > Cc: dgutov@yandex.ru, joostkremers@fastmail.fm, emacs-devel@gnu.org > Date: Tue, 16 Nov 2021 15:24:09 +0100 > > Eli Zaretskii writes: > > > 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. > > They are still in the lispref manual (and indexed, if I didn't mess that > up), so people should be able to find them. The names are there, but not the signatures, and there isn't even a minimal description of the arguments. That is too radical, IMO. > A manual is primarily for people who are writing new code, not for > rooting out how legacy functions work. The manual is also for people who want to understand what the code they look at does. > The built-in doc system is better for that. Then why do we have the ELisp manual at all? I'm really unhappy about deleting that from the manual. Would you mind if I added back some minimal docs?