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: Wed, 31 Aug 2022 11:58:41 +0200 Message-ID: <87o7w091ke.fsf@gnus.org> References: <5d87e4ab47875790076e932351fe8f25@webmail.orcon.net.nz> <87ilw3vnp7.fsf@gnus.org> <87mtlfu5u4.fsf@gnus.org> <87v8qlkyvw.fsf@gnus.org> <878rnfkel7.fsf@web.de> <87tu63s0mg.fsf@gnus.org> <87o7w1macy.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="23476"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: Phil Sainty , 52290@debbugs.gnu.org, Stefan Monnier To: Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Aug 31 11:59:22 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 1oTKVG-0005uW-2i for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 31 Aug 2022 11:59:22 +0200 Original-Received: from localhost ([::1]:49120 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oTKVF-0005tl-3Q for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 31 Aug 2022 05:59:21 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52680) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oTKUx-0005jk-7o for bug-gnu-emacs@gnu.org; Wed, 31 Aug 2022 05:59:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:48488) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oTKUw-0002LK-WB for bug-gnu-emacs@gnu.org; Wed, 31 Aug 2022 05:59:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oTKUw-0000s8-So for bug-gnu-emacs@gnu.org; Wed, 31 Aug 2022 05:59: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: Wed, 31 Aug 2022 09:59:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52290 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: moreinfo Original-Received: via spool by 52290-submit@debbugs.gnu.org id=B52290.16619399413334 (code B ref 52290); Wed, 31 Aug 2022 09:59:02 +0000 Original-Received: (at 52290) by debbugs.gnu.org; 31 Aug 2022 09:59:01 +0000 Original-Received: from localhost ([127.0.0.1]:38235 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oTKUv-0000rd-5M for submit@debbugs.gnu.org; Wed, 31 Aug 2022 05:59:01 -0400 Original-Received: from quimby.gnus.org ([95.216.78.240]:40196) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oTKUm-0000rI-9A for 52290@debbugs.gnu.org; Wed, 31 Aug 2022 05:58:59 -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=q20sNvxe6UrP9yYaNU8p/NHnTcEVIILBLwXV8C+RVKE=; b=K+IhgbDWQKYle6e4fzJiDuv8// LL5YptJIkXx5VAor+4F/12NIQNnzRrLmQvm2tyf3s2ItjJ3RmQVdYIf+7A3RHkNNkNujX+KTX/Oxh a4gzU6bIBea1jf4Ppz5DgboOw+lWk+JhelK36ARscG70OYfMTnoVfdYsV2GFlHJWns3c=; 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 1oTKUc-0008PJ-31; Wed, 31 Aug 2022 11:58:44 +0200 In-Reply-To: <87o7w1macy.fsf@web.de> (Michael Heerdegen's message of "Wed, 31 Aug 2022 04:10:21 +0200") Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwAgMAAAAqbBEUAAAABGdBTUEAALGPC/xhBQAAACBj SFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAADFBMVEXR0MuAf31OTU3/ //8fmzB2AAAAAWJLR0QDEQxM8gAAAAd0SU1FB+YIHwkyOYlnucEAAAFVSURBVCjPTdKxTsMwEAbg /6I4opmCRJHSHUTzFI7UdmDy0A7NxACoyVOABBJjQChSmTokqL6nxGfTKh5sf7J9PucCIGdpWwPX 1LPMbdMKGv4Rdd9uTtz5bYMgsZB5Pz86pEcS6HTrMDtEsoBkL3gtuCoNonfB/Ywz0qCVgLUFuahf HswboNp8SjR3O+uIl4LE3cdtxGbwGUhk4t6G3Kqhp21W+6z3arN2460AH77HzRiFlv5ijEnAfIw7 jFd8n46RAOv4DI06B+oTCvfRbECLqQt7PEFaH+AHCkgtcW0uw7ZZRU8GV/9IJat1uGebaGVol3tM qVet2k10gCUXUnnExEtzfSCPRc7d4KrokdXc7bnUmYetpFovfoW44sHiIeTGK4vHM0ouWxx0QMu/ Gv4hk4j7hkFvEq1I5G9BtCApSRlKH2clqCnrxr1SKRhQRU3tDsfKZH96SXyAqR/HgQAAACV0RVh0 ZGF0ZTpjcmVhdGUAMjAyMi0wOC0zMVQwOTo1MDo1NyswMDowMK0a7qIAAAAldEVYdGRhdGU6bW9k aWZ5ADIwMjItMDgtMzFUMDk6NTA6NTcrMDA6MDDcR1YeAAAAAElFTkSuQmCC X-Now-Playing: Rival Consoles's _Kid Velo_: "Into The Heart I" 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:241173 Archived-At: Michael Heerdegen writes: > Ok - not that easy! Alternatives I see are "... `setf'able'" or > "... can be used in generalized variables" or "...in place expressions" > or "can be used in gv forms - see [Generalized Variables]." "`setf'-able" is perhaps an improvement -- I think more people know what that means than "generalized variable". > BTW, another problem is that `alist-get' tells how it works as place > (because it's not totally trivial in this case), and at the end "... is > also a generalized variable" is added - kind of misplaced because the > reader already knows at this point. Personally I would prefer that hint > near the beginning (without "also") - in all cases I think. The user has asked for the documentation for the function, so "also" is appropriate. And the info (that's it's setf-able) is unlikely to be what most people are interested in, so keeping it at the bottom is fine.