emacs: add docstring for notmuch-show-choose-duplicate

It should have one in any case, but in particular it is needed for the
manual.
This commit is contained in:
David Bremner 2022-07-31 09:46:51 -03:00
parent d273263d16
commit 5a47b5a884

View file

@ -1135,6 +1135,16 @@ is t, hide the part initially and show the button."
(make-variable-buffer-local 'notmuch-show-previous-subject) (make-variable-buffer-local 'notmuch-show-previous-subject)
(defun notmuch-show-choose-duplicate (duplicate) (defun notmuch-show-choose-duplicate (duplicate)
"Display message file with index DUPLICATE in place of the current one.
Message file indices are based on the order the files are
discovered by `notmuch new' (and hence are somewhat arbitrary),
and correspond to those passed to the \"\\-\\-duplicate\" arguments
to the CLI.
When called interactively, the function will prompt for the index
of the file to display. An error will be signaled if the index
is out of range."
(interactive "Nduplicate: ") (interactive "Nduplicate: ")
(let ((count (length (notmuch-show-get-prop :filename)))) (let ((count (length (notmuch-show-get-prop :filename))))
(when (or (> duplicate count) (when (or (> duplicate count)