emacs-devel
[Top][All Lists]
Advanced

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

Re: master baf1a7a4a0: Turn gv-synthetic-place into a function


From: Eli Zaretskii
Subject: Re: master baf1a7a4a0: Turn gv-synthetic-place into a function
Date: Fri, 23 Sep 2022 13:53:38 +0300

> From: Michael Heerdegen <michael_heerdegen@web.de>
> Date: Fri, 23 Sep 2022 11:41:07 +0200
> 
> >  How about
> >
> >   This macro evaluates FORM and stores its value in PLACE, ...
> 
> We could also say (a bit more similar to the first sentence of the
> `setq' docstring):
> 
>   -- Macro: setf [gv val]...
>       Set each place described by the generalized variable GV to its VAL.
>       ...

Generalized variables don't "describe" places, they _are_ places.

Also, "set a place" has the same problem of conflicting with the
"usual" meaning of the word "place", so it's potentially confusing.

Replacing word by word due to an analogy doesn't always lead to clear
documentation, IME.



reply via email to

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