From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Phil Sainty Newsgroups: gmane.emacs.bugs Subject: bug#52290: 28.0.90; Undocumented generalized variables Date: Sun, 05 Dec 2021 15:09:09 +1300 Message-ID: References: <5d87e4ab47875790076e932351fe8f25@webmail.orcon.net.nz> <87ilw3vnp7.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33036"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Orcon Webmail Cc: 52290@debbugs.gnu.org, Stefan Monnier To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Dec 05 03:10:20 2021 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 1mtgyq-0008S4-Ex for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 05 Dec 2021 03:10:20 +0100 Original-Received: from localhost ([::1]:42274 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtgyp-0000si-9g for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 04 Dec 2021 21:10:19 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:41888) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtgyY-0000rj-HL for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 21:10:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44348) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mtgyY-0006Uh-8i for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 21:10:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mtgyY-0006yu-4B for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 21:10:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Phil Sainty Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Dec 2021 02:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52290 X-GNU-PR-Package: emacs Original-Received: via spool by 52290-submit@debbugs.gnu.org id=B52290.163867015526728 (code B ref 52290); Sun, 05 Dec 2021 02:10:02 +0000 Original-Received: (at 52290) by debbugs.gnu.org; 5 Dec 2021 02:09:15 +0000 Original-Received: from localhost ([127.0.0.1]:55889 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mtgxm-0006x2-Md for submit@debbugs.gnu.org; Sat, 04 Dec 2021 21:09:14 -0500 Original-Received: from smtp-1.orcon.net.nz ([60.234.4.34]:43729) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mtgxl-0006wt-BE for 52290@debbugs.gnu.org; Sat, 04 Dec 2021 21:09:13 -0500 Original-Received: from [10.253.37.70] (port=19605 helo=webmail.orcon.net.nz) by smtp-1.orcon.net.nz with esmtpa (Exim 4.90_1) (envelope-from ) id 1mtgxh-0005Fy-Lx; Sun, 05 Dec 2021 15:09:09 +1300 Original-Received: from ip-14-137-22-223.kinect.net.nz ([14.137.22.223]) via [10.253.37.253] by webmail.orcon.net.nz with HTTP (HTTP/1.1 POST); Sun, 05 Dec 2021 15:09:09 +1300 In-Reply-To: <87ilw3vnp7.fsf@gnus.org> X-Sender: psainty@orcon.net.nz X-GeoIP: -- X-Spam_score: -2.9 X-Spam_score_int: -28 X-Spam_bar: -- 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" Xref: news.gmane.io gmane.emacs.bugs:221566 Archived-At: On 2021-12-05 14:35, Lars Ingebrigtsen wrote: > I don't think many of those are new -- they were just moved from > cl-lib.el to gv.el, because it seemed weird to have them in cl-lib.el. Aha. I'd seen that the cl docs had a bunch of extensions, but didn't think to re-check those docs in 28.0.90. > But we don't really have a deprecation mechanisme for generalised > variables, so it's just hard. I guess we'd want a new define-obsolete-* function, and for the setf macro to be flagging uses of obsolete PLACE forms at compile time? It looks to me as if `gv-get' might be the right place to be checking this (but I'm only looking at the internals for the first time and don't have a good handle on this stuff). > The manual should absolutely not list most of these, because we don't > want anybody to use them, and we want to remove many (most?) of the > undocumented ones. > > We just have to figure out how to do that in an orderly fashion. Fair enough. Should we start by deciding which ones we *should* document, and at least get that much added for 28.1? `buffer-local-value' is a clear "yes" vote from me (and I don't currently have an opinion on anything else). -Phil