; 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 27a9e2b0ebbe812bcb6406e0367b84c326b9de1f..e244a03eabbdd3427c52a76c53a32ff16ea7fda4 100644 (file)
--- 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 0c93b18eea1e5e7f61b26f21a3e894d8675a50d5..47529b02d22e5a0b53fbf1dbf1f4dc138cde574d 100644 (file)
--- 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))