Subject: Re: bug#66117: 30.0.50; `find-buffer-visiting' is slow when opening large number of buffers

From: Ihor Radchenko <[email-masked]>
Date: Tue, 02 Jan 2024 12:07:59 +0000

Gerd Möllmann <[email-masked]> writes:

>> In my example, SYMBOL does get its own value in the buffer, but
>> `default-value' still returns 'default-value.
>
> I assume you mean the example from above? This one:

Yes.

>>>> (defvar-local yant/test 'default-value)
>>>> (with-temp-buffer
>>>>   (setq yant/test 'local-value)
>>>>   (default-value 'yant/test)) ; => 'default-value
>
> If so, the "gets its own ... _but_ default-value still returns..." hints
> at the misunderstanding, maybe. It should be something like "because it
> gets its own..., default-value returns...".
>
> Maybe one could reformulate the doc string of default-value like this?
>
>   Return SYMBOL’s default value.
>   This is the value that is seen in buffers that do not have their own values
>   for this variable.
>
> =>
>
>   Return SYMBOL’s default value.
>   This is the value that would be seen in the buffer if it didn't have
>   its own value.
>
> Although I find the original clearer...

Both versions are actually clear for me. What was not clear for me is
how the docstring explains my `let' example.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>