[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#52290: 28.0.90; Undocumented generalized variables
From: |
Lars Ingebrigtsen |
Subject: |
bug#52290: 28.0.90; Undocumented generalized variables |
Date: |
Wed, 31 Aug 2022 11:58:41 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) |
Michael Heerdegen <michael_heerdegen@web.de> 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.