Subject: Re: bug#43307: 28.0.50; `diff-no-select': no documentation for BUF argument

From: Lars Ingebrigtsen <[email-masked]>
Date: Thu, 10 Sep 2020 23:04:14 +0200

Philipp Stephani <[email-masked]> writes:

> The signature for `diff-no-select' is:
>
> (diff-no-select OLD NEW &optional SWITCHES NO-ASYNC BUF)
>
> Its docstring refers to `diff' for the meaning of the arguments, but
> `diff' doesn't take an argument, so BUF is undocumented.
>
> Probably `diff-no-select' should also document that the return value is
> BUF if BUF is non-nil.

I've now amended the doc string of the function on Emacs 28.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no