From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#52290: 28.0.90; Undocumented generalized variables Date: Sun, 05 Dec 2021 02:35:00 +0100 Message-ID: <87ilw3vnp7.fsf@gnus.org> References: <5d87e4ab47875790076e932351fe8f25@webmail.orcon.net.nz> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3882"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: 52290@debbugs.gnu.org, Stefan Monnier To: Phil Sainty Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Dec 05 02:36:13 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 1mtgRp-0000nZ-Ap for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 05 Dec 2021 02:36:13 +0100 Original-Received: from localhost ([::1]:33978 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtgRn-0001vM-GE for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 04 Dec 2021 20:36:11 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:36164) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtgRe-0001tB-QS for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 20:36:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:44271) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mtgRe-00020A-4L for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 20:36:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mtgRd-0001Ky-Qo for bug-gnu-emacs@gnu.org; Sat, 04 Dec 2021 20:36:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 05 Dec 2021 01:36:01 +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.16386681135039 (code B ref 52290); Sun, 05 Dec 2021 01:36:01 +0000 Original-Received: (at 52290) by debbugs.gnu.org; 5 Dec 2021 01:35:13 +0000 Original-Received: from localhost ([127.0.0.1]:55817 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mtgQr-0001JB-A5 for submit@debbugs.gnu.org; Sat, 04 Dec 2021 20:35:13 -0500 Original-Received: from quimby.gnus.org ([95.216.78.240]:44196) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mtgQp-0001Im-A6 for 52290@debbugs.gnu.org; Sat, 04 Dec 2021 20:35:11 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=RexqYFBAE1ufO1IcRPZ2OeVyfbd/YcJV8ZjVMtD7DgU=; b=u7PQt7uFCQwocQaAqg1nmNCa88 7pPR85/jpyGwuipkG5khHLfT9rpqV/SBBVwRFwlZbbh/W/8jhuGf2NPDqUZBczat84mzZPHqnrODs XfuTewylxZpU8Q2R6eAfp0/gJIxsxkHmQCWfxlTYp3VX+mZZj31BMxwBLberyrcxnVxE=; Original-Received: from [84.212.220.105] (helo=xo) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mtgQe-0002ai-UY; Sun, 05 Dec 2021 02:35:04 +0100 Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAABGdBTUEAALGPC/xhBQAAACBj SFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAJFBMVEW6FizDFS5nNx5s SyF3MSGlIyiMKiVXWB6QGyRcXiCEQyf///+m4zYeAAAAAWJLR0QLH9fEwAAAAAd0SU1FB+UMBQEf JIjovdoAAAEWSURBVDjLrdRBS8MwFADg9xgd9Pbe5oY7i3draRFPk1nZUZBlHgPOULzKhkdlMq+7 tPhzzaIDWfPGAsuhh3x5ee8loQBucGMAEDCyD6wQ2q9lIrJrkJjs9Fmh553Z8ulx9cnZ3e2w3S3U Tesyh7STrQfng+lV2qOqqjGNW9cRaA3zL5NMkwf1vZ716qo+XbzEcdmPPuBtOXp+XaTvdZZ3TX4x zvORStQJglHGFKbU923dVyszNGZSTiBiTwfbchFopw/8BSkCgyF8K9gH/6NIApRgG9KEg5IfC1AE ksAvm63Is5t9ckzsh+ad/4EVX8mb10x+QBHI2yO4sgKPJBj4eCAkAemm3JEIEWKOgOTE7pe0C+Rm fwDqiV9uYmYg8wAAACV0RVh0ZGF0ZTpjcmVhdGUAMjAyMS0xMi0wNVQwMTozMTozNiswMDowMDbX BPAAAAAldEVYdGRhdGU6bW9kaWZ5ADIwMjEtMTItMDVUMDE6MzE6MzYrMDA6MDBHirxMAAAAAElF TkSuQmCC X-Now-Playing: Talking Heads's _77_: "Pulled Up" In-Reply-To: <5d87e4ab47875790076e932351fe8f25@webmail.orcon.net.nz> (Phil Sainty's message of "Sun, 05 Dec 2021 14:25:54 +1300") 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:221555 Archived-At: Phil Sainty writes: > In 28.0.90 the list is huge: 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. And we probably want to deprecate a whole bunch of them, because many of them are just nonsensical. But we don't really have a deprecation mechanisme for generalised variables, so it's just hard. > I think the manual should list these, but also at this point I think > the help for any generalized variable should *automatically* state > that fact, so that any future omissions are still covered to some > extent, and also so that non-standard generalized vars defined by > other libraries will have some documentation. 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. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no