From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#74630: 31.0.50; emacs-mail-verify Date: Sun, 01 Dec 2024 14:53:46 +0200 Message-ID: <868qsz5ztx.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39835"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 74630@debbugs.gnu.org To: rms@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Dec 01 13:57:25 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1tHjVs-000ADP-Rh for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 01 Dec 2024 13:57:24 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tHjVY-0006Sw-Ib; Sun, 01 Dec 2024 07:57:04 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tHjVX-0006Se-Ha for bug-gnu-emacs@gnu.org; Sun, 01 Dec 2024 07:57:03 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tHjVX-0002VV-8r for bug-gnu-emacs@gnu.org; Sun, 01 Dec 2024 07:57:03 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=References:In-Reply-To:From:Date:To:Subject; bh=LrWIYf9Lnzqrg+awj5mgmiEikjq1myW3LSfA0BuQO6o=; b=Mnlyjrc7KI/UhLvfgGkVnoKm7CHzZTqRcGkLxCyl//10qVHiAldbw67fjqlp3fzGJU8hsgBhoXKrlNbi/11dOsfIiZJDJl5C1P+H9PX8eU92NxXN3PHsycI8Mqqz13MhC90FQXo/dx9nZaNVFGv8Kg4Q/z3e+oiF6yFeMPW+xJaG5OAeHyXgW36S/a6EIwYaosPvmcuezkFM9CjMgdnl+A9m02xGOOypRFcMB5grqgBwxpzOcvffrgcz1kxaa7Is4RoVSmnMx/vHgWEUgFVu9XtS4iizN4VeSWs1ENLkXXm3dVuUOpW7fKGTB6jBTdEJtQtV4sLG7sOelpZpwHpZFw==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tHjVW-0007nN-Kz for bug-gnu-emacs@gnu.org; Sun, 01 Dec 2024 07:57:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 01 Dec 2024 12:57:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 74630 X-GNU-PR-Package: emacs Original-Received: via spool by 74630-submit@debbugs.gnu.org id=B74630.173305779229906 (code B ref 74630); Sun, 01 Dec 2024 12:57:02 +0000 Original-Received: (at 74630) by debbugs.gnu.org; 1 Dec 2024 12:56:32 +0000 Original-Received: from localhost ([127.0.0.1]:50657 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tHjV1-0007mH-6G for submit@debbugs.gnu.org; Sun, 01 Dec 2024 07:56:31 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:56834) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tHjUx-0007ly-Rh for 74630@debbugs.gnu.org; Sun, 01 Dec 2024 07:56:28 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tHjSh-0001VI-Oa for 74630@debbugs.gnu.org; Sun, 01 Dec 2024 07:54:11 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=LrWIYf9Lnzqrg+awj5mgmiEikjq1myW3LSfA0BuQO6o=; b=iJA5zExY9J3X OZX/SLjtOu/myt0wjyoRTg3g3T2j0zqKfCc9Ax8fMVEnle2SDKBZ0kTovubxixro6FjQOU0Hh71b/ 4hvDLQpuvNQBUjZ7EJHeKwaGbt2dLKT/Sfve6+tVonFdEUNxHZYvT26IvCcBIqpLsCm0kFQIGU3/E yO4T/rjiGVLG+7+QxAMNKSy6nDrQWgmknHKf3pED2O+LPtjkQI8y33Npgw9wd1VmSSq1/fsO4/N76 +OqftJRbNYn5zofxhdwW24H1qFsQc0v85uTVmQPdhlsG1HDAsPAICFD50tDc702q1mZyOKrGl1wNT MvGPTvia/z2iOjWB1nAqzw==; In-Reply-To: (message from Richard Stallman on Sun, 01 Dec 2024 00:39:00 -0500) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:296246 Archived-At: > From: Richard Stallman > Date: Sun, 01 Dec 2024 00:39:00 -0500 > > > The doc string of `emacs-mail-verify' does not say how it > indicates that the signature is valid, or how it indicates > that the signature is not valid. I guess you meant epa-mail-verify? > Would someone please add that to its doc string? Not sure what you expected the doc string to say. Would the below be enough? Verify OpenPGP cleartext signed messages in the current buffer. The buffer is expected to contain a mail message. If the verification fails, the command signals an error. The last sentence describes the following snippet from epa-verify-region, which epa-mail-verify calls: (unless (epg-context-result-for context 'verify) (error "Unable to verify region")) There are also other reasons to signal an error, e.g. if there are no "-----BEGIN PGP SIGNED MESSAGE-----" line. But eventually, all of the problems cause an error. If this is somehow not detailed enough, then I'm afraid someone else, who knows the code, will have to improve the doc string, because I could see no clear description in the code what values could the context-result have and what is the meaning of each result. Maybe I missed something.