emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: master 48aacbf292 2/2: Make many seldom-used generalized variables o


From: Stefan Monnier
Subject: Re: master 48aacbf292 2/2: Make many seldom-used generalized variables obsolete
Date: Sat, 10 Sep 2022 10:25:53 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)

>> Would it be possible to accept docstring in gv-define-setter and then
>> display it in the help buffer for the relevant variable?
> It would be possible, but then we'd just be encouraging people to write
> illegible code.

Largely agreed.  There is some occasional need for documentation of the
setter, for example we could argue that `alist-get` (when used as a gv)
should document that the ALIST argument needs to be a gv-place as
well.  But when needed it can be added to the function's docstring.
So, I'm leaning towards YAGNI.


        Stefan




reply via email to

[Prev in Thread] Current Thread [Next in Thread]