emacs-30 d50293b0f10: ; Improve documentation of 'epa-mail-verify'

[Eli Zaretskii]

branch: emacs-30
commit d50293b0f108ff85796dc56312a1c46c8db4f8a1
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; 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)
---
 doc/misc/epa.texi | 3 ++-
 lisp/epa-mail.el  | 4 +++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/misc/epa.texi b/doc/misc/epa.texi
index f450b9cbdd9..58c2a111348 100644
--- a/doc/misc/epa.texi
+++ b/doc/misc/epa.texi
@@ -398,7 +398,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))