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: Mon, 22 Aug 2022 00:36:19 +0200 Message-ID: <87v8qlkyvw.fsf@gnus.org> References: <5d87e4ab47875790076e932351fe8f25@webmail.orcon.net.nz> <87ilw3vnp7.fsf@gnus.org> <87mtlfu5u4.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="40480"; 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 Mon Aug 22 00:37:11 2022 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 1oPtZ8-000AJd-PU for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 22 Aug 2022 00:37:10 +0200 Original-Received: from localhost ([::1]:39966 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oPtZ7-00070H-Q2 for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 21 Aug 2022 18:37:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35944) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oPtZ0-0006zL-Rl for bug-gnu-emacs@gnu.org; Sun, 21 Aug 2022 18:37:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:47296) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oPtZ0-0002uS-JC for bug-gnu-emacs@gnu.org; Sun, 21 Aug 2022 18:37:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oPtZ0-00078S-8y for bug-gnu-emacs@gnu.org; Sun, 21 Aug 2022 18:37:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 21 Aug 2022 22:37: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.166112139427385 (code B ref 52290); Sun, 21 Aug 2022 22:37:02 +0000 Original-Received: (at 52290) by debbugs.gnu.org; 21 Aug 2022 22:36:34 +0000 Original-Received: from localhost ([127.0.0.1]:37043 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oPtYX-00077Y-Qi for submit@debbugs.gnu.org; Sun, 21 Aug 2022 18:36:34 -0400 Original-Received: from quimby.gnus.org ([95.216.78.240]:47042) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oPtYV-00077I-J5 for 52290@debbugs.gnu.org; Sun, 21 Aug 2022 18:36:31 -0400 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:Date:References: In-Reply-To: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=z5Zxu0tGzLZQ6fyvZV7+6PK+tFX7POe6ZsnSu63zOdQ=; b=e/HGz80WQdEL2wTPB1QUTSTAMm yCTSLBJDY7v1J5YS6k/EJAEB+1F+lFXo4j3va5pj7fdV7TxGi9oDg7DH04HNgJhImynFHOPfURShG D8lPBJaHzdeOyrEfz8fF/YNscHrkGwXUarsAjo7eqG0qP88eufJyR9WQKOCmLHdP82+E=; Original-Received: from [84.212.220.105] (helo=joga) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oPtYK-0006r4-E9; Mon, 22 Aug 2022 00:36:22 +0200 In-Reply-To: <87mtlfu5u4.fsf@gnus.org> (Lars Ingebrigtsen's message of "Sun, 05 Dec 2021 03:46:11 +0100") X-Now-Playing: Richard and Linda Thompson's _Hard Luck Stories (6): First Light_: "Restless Highways" 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:240368 Archived-At: Lars Ingebrigtsen writes: > I think we should implement the obsoletion mechanism and then just go > through that list and obsolete all the stuff that doesn't seem useful > (and isn't used in-tree). And then document the rest, as well as make > the *Help* buffer mention that they're generalised variables. The obsoletion mechanism is now in place in Emacs 29, and I've obsoleted a whole bunch of nonsensical gv-setters. (Feel free to obsolete more of them, everybody.) I've now made *Help* mention whether a function is a generalised variable. I'm not sure there's need to document all the generalised variables in the manual, though. The *Help* buffer should be sufficient, and if they're not obvious (i.e., need documentation), then they should probably be obsoleted. But it might be nice to document, say, `if'.