From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#52290: 28.0.90; Undocumented generalized variables Date: Wed, 31 Aug 2022 04:10:21 +0200 Message-ID: <87o7w1macy.fsf@web.de> 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> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6693"; 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: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Aug 31 04:11: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 1oTDCA-0001YO-Ob for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 31 Aug 2022 04:11:10 +0200 Original-Received: from localhost ([::1]:45906 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oTDC9-0001vk-H5 for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 30 Aug 2022 22:11:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44262) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oTDC3-0001vb-78 for bug-gnu-emacs@gnu.org; Tue, 30 Aug 2022 22:11:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:48070) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oTDC2-0007eI-Tq for bug-gnu-emacs@gnu.org; Tue, 30 Aug 2022 22:11:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oTDC2-0007h6-CJ for bug-gnu-emacs@gnu.org; Tue, 30 Aug 2022 22:11:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 31 Aug 2022 02:11: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.166191185029558 (code B ref 52290); Wed, 31 Aug 2022 02:11:02 +0000 Original-Received: (at 52290) by debbugs.gnu.org; 31 Aug 2022 02:10:50 +0000 Original-Received: from localhost ([127.0.0.1]:37819 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oTDBp-0007gg-Qm for submit@debbugs.gnu.org; Tue, 30 Aug 2022 22:10:50 -0400 Original-Received: from mout.web.de ([212.227.17.11]:43957) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oTDBm-0007gQ-Hb for 52290@debbugs.gnu.org; Tue, 30 Aug 2022 22:10:48 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1661911823; bh=JLlPRw9ZdKbGsMQyK+MTVE3xrCSwlw7TVyVYj7glac4=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date; b=MTULnXLGp5ojGxkhhxvbUbwBQXsHhk9inqRkTJQg5H6NCgwbOW1mXWsZpDHtARh21 VTHZ2m1hib2wxfhe4MxlY3xQhr7sriQFLLSgu2HIRIaH0TnCD+rCysxL7J/22y7KG/ fFk6dqLiWilwkyQeWbqczD+23S0ToXa013ObdIck= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Original-Received: from drachen.dragon ([84.57.248.18]) by smtp.web.de (mrweb106 [213.165.67.124]) with ESMTPSA (Nemesis) id 1Ml4B4-1p7orj1MI0-00lPNx; Wed, 31 Aug 2022 04:10:23 +0200 In-Reply-To: <87tu63s0mg.fsf@gnus.org> (Lars Ingebrigtsen's message of "Tue, 23 Aug 2022 12:41:27 +0200") X-Provags-ID: V03:K1:wBdRAfsC8FBFj/HKooG67f+mNpLpoRzH0gjdOSIrY32bophDE7x cXdO14/5n+YuQ0jZUIJHFCw3EiXuI7cKmTBtTY3vN/Uj2CMWmfKmtvQ1hD6wGDEodRHthK4 zXb4OfUccZxfffrZOvae8SRu9yC2aDstKk6BOQmpdtc/ck9tJ1udHM0JXm9OKITgqyhd2FN jmQJ6jK/rbRsoPv9dpHwQ== X-UI-Out-Filterresults: notjunk:1;V03:K0:0yayF7iVVHw=:+llN5fVEuMwBZ43Ke1QAIw 9Vgy1sY0ecsJlGYLBDUKwQt3/J7nH3s2epKcFcc00C32UlfuEFTrzePqgTqPGsws9VpL+3YBw tybC57L1rS+J/AR9tNuoxEa2tpAdyHf1Ts5i4jF1K/EzTNPWVRMTLAf7EQeAbSauAsb0JEPd7 RHY7vz2/5bat1BoipSi+29T3dZ78WgYx0WRIpg/ubh/MYubcS6JmnlDS3ECaGSRntzYmpczZq Bc2CefVAs6MPTarp4491Q3uboNk7g05XGnM2qadVObvE+RkDxOqtEn72mIZbOKkQcc1fol6tr 2+SurUxXfH8pby/I3sbrEgWCDu0i2SnvXt74FP9cT70yL3rYjdufk2nqOogVnY8MT0wpwTWpD y6XGxM4SD1JllwzSnvF77NkhqUi79cwT8rwJ7Kci09OptYqKYQpQcKVK3/Pnft5EBUw9q2+p6 QQVbvXVzBerKvJLdZh98RxqjbqEToAFsnNeqGMf/rQGzln1yKx/dmmEhHNKtz0+DHH6XqVNtZ FZ8fh4JRLdyvKqgX9O9qULJuBgndJMHieN5kz1tfYtr2FtuvTbcYqlxP0qIM7Z9kYzhkH2RiY Q0zwxeFeMB8bTH6lwyAn6HocUdSujis8Yn0ij5TpXDrIqkrcA7EEqN7PZQOsLaJAXW6QVEZE2 jp1BgKHmAH2Mcil7Q73AbPLA3Om7ZRcXNLIfs1RnPeheB7VaGe3oiQHrrPhZTE0IhoRVQXOMO Lj7QWzeOr/XzvVKWo74M7AZA7tspW+NO7urKwIV4ETkUae2dEIZ+1zyV9UdwwhlgpyT4JiT8 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:241158 Archived-At: Lars Ingebrigtsen writes: > > Can we try to find a better wording? Not the function is a generalized > > variable, a form that is a call of the function is. [...] > Yes, please do tweak the wording. I couldn't find any concise way of > saying something here accurately, so I went for vague instead (note that > I don't mention "function" anywhere in the text), and just punt to the > manual. 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]." Does something like that sound better than what we have? 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. WDYT? TIA, Michael.