From: Eli Zaretskii <eliz@gnu.org>
Date: Wed, 4 Dec 2024 13:21:13 +0000 (+0200)
Subject: ; Improve documentation of 'epa-mail-verify'
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=10baa2abcc735af74b19857b75132b05f65aa119;p=emacs.git

; Improve documentation of 'epa-mail-verify'

* doc/misc/epa.texi (Mail-mode integration):
* lisp/epa-mail.el (epa-mail-verify): Improve documentation of
'epa-mail-verify'.  (Bug#74630)

(cherry picked from commit d50293b0f108ff85796dc56312a1c46c8db4f8a1)
---

diff --git a/doc/misc/epa.texi b/doc/misc/epa.texi
index 27a9e2b0ebb..e244a03eabb 100644
--- a/doc/misc/epa.texi
+++ b/doc/misc/epa.texi
@@ -389,7 +389,8 @@ Decrypt OpenPGP armors in the current buffer.
 @kindex C-c C-e C-v
 @kindex C-c C-e v
 @findex epa-mail-verify
-Verify OpenPGP cleartext signed messages in the current buffer.
+Verify OpenPGP cleartext signed messages in the current buffer.  If
+verification fails for some reason, this command signals an error.
 
 @item C-c C-e C-s and C-c C-e s
 @kindex C-c C-e C-s
diff --git a/lisp/epa-mail.el b/lisp/epa-mail.el
index 0c93b18eea1..47529b02d22 100644
--- a/lisp/epa-mail.el
+++ b/lisp/epa-mail.el
@@ -90,7 +90,9 @@ The buffer is expected to contain a mail message."
 ;;;###autoload
 (defun epa-mail-verify ()
   "Verify OpenPGP cleartext signed messages in the current buffer.
-The buffer is expected to contain a mail message."
+The buffer is expected to contain a mail message.
+
+If the verification fails, signal an error."
   (declare (interactive-only t))
   (interactive)
   (with-suppressed-warnings ((interactive-only epa-verify-cleartext-in-region))