|
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
[Prev in Thread] | Current Thread | [Next in Thread] |