From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Thu, 10 Sep 2020 21:03:50 +0000 (+0200)
Subject: Doc fix for diff-no-select
X-Git-Tag: emacs-28.0.90~6139
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=da344e1884481e8d5e294b0f46df447c234bab41;p=emacs.git

Doc fix for diff-no-select

* lisp/vc/diff.el (diff-no-select): Document the BUF argument
(bug#43307).
---

diff --git a/lisp/vc/diff.el b/lisp/vc/diff.el
index 9e7e771963c..2ed8573c07d 100644
--- a/lisp/vc/diff.el
+++ b/lisp/vc/diff.el
@@ -145,9 +145,13 @@ Possible values are:
 
 (defun diff-no-select (old new &optional switches no-async buf)
   ;; Noninteractive helper for creating and reverting diff buffers
-  "Compare the OLD and NEW file/buffer, and return a diff buffer.
+  "Compare the OLD and NEW file/buffer.
 
-See `diff' for the meaning of the arguments."
+If BUF is nil, the \"*Diff*\" buffer will be used as the diff
+buffer.  If non-nil, BUF will be used as the diff buffer.  The
+buffer used will be returned by this value.
+
+See `diff' for the meaning of the SWITCHES and NO-ASYNC arguments."
   (unless (bufferp new) (setq new (expand-file-name new)))
   (unless (bufferp old) (setq old (expand-file-name old)))
   (or switches (setq switches diff-switches)) ; If not specified, use default.