From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jens Schmidt via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#64154: Some additions to the EasyPG Assistant's manual Date: Sun, 9 Jul 2023 12:18:39 +0200 Message-ID: <99ae7aa0-fe0a-42a3-53e2-678507232e90@vodafonemail.de> References: <83wn02r0s7.fsf@gnu.org> <26dac916-117c-d8a1-ad97-0e3e9313ff71@vodafonemail.de> <83a5w5bl8q.fsf@gnu.org> Reply-To: Jens Schmidt Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="34571"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.12.0 Cc: 64154@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Jul 09 12:20:21 2023 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 1qIRWe-0008mg-Mw for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 09 Jul 2023 12:20:20 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qIRWN-0001CZ-En; Sun, 09 Jul 2023 06:20:03 -0400 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 1qIRWM-0001CP-CD for bug-gnu-emacs@gnu.org; Sun, 09 Jul 2023 06:20:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qIRWM-0005t5-1c for bug-gnu-emacs@gnu.org; Sun, 09 Jul 2023 06:20:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qIRWL-0004tO-TO for bug-gnu-emacs@gnu.org; Sun, 09 Jul 2023 06:20:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Jens Schmidt Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 09 Jul 2023 10:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 64154 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 64154-submit@debbugs.gnu.org id=B64154.168889794318735 (code B ref 64154); Sun, 09 Jul 2023 10:20:01 +0000 Original-Received: (at 64154) by debbugs.gnu.org; 9 Jul 2023 10:19:03 +0000 Original-Received: from localhost ([127.0.0.1]:45872 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qIRVP-0004s5-2e for submit@debbugs.gnu.org; Sun, 09 Jul 2023 06:19:03 -0400 Original-Received: from mr4.vodafonemail.de ([145.253.228.164]:41610) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qIRVN-0004rb-Ec for 64154@debbugs.gnu.org; Sun, 09 Jul 2023 06:19:01 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=vodafonemail.de; s=vfde-mb-mr2-21dec; t=1688897935; bh=MUBrUrE9adD3IUlWBtUy93QDdoyztn7S6Myzht7zk9s=; h=Message-ID:Date:User-Agent:Subject:To:References:Content-Language: From:In-Reply-To:Content-Type:From; b=LAcbNXCnimEtmnFNuE4ZM6WQvyyZEkwILHupvLLBg3xs/trXyRODRG6DxPtiDiwna HbkHTYa6OXDDQ+DSpt3Miv2lbIKVg6uTUyK/F5IJIxZdn5ykjpbH9P9E5CeGKgNxY0 y97SbooRPZ9jgm31bBNZRSqBJ+qYFj7L3rYfMiUg= Original-Received: from smtp.vodafone.de (unknown [10.0.0.2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by mr4.vodafonemail.de (Postfix) with ESMTPS id 4QzNQR2lQcz1yBZ; Sun, 9 Jul 2023 10:18:55 +0000 (UTC) Original-Received: from [192.168.178.41] (port-92-194-126-63.dynamic.as20676.net [92.194.126.63]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by smtp.vodafone.de (Postfix) with ESMTPSA id 4QzNQH403rzMmXG; Sun, 9 Jul 2023 10:18:44 +0000 (UTC) Content-Language: de-DE-frami, en-US In-Reply-To: <83a5w5bl8q.fsf@gnu.org> X-purgate-type: clean X-purgate: clean X-purgate-size: 2939 X-purgate-ID: 155817::1688897930-4CFF9A5E-1C86C4AF/0/0 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:264830 Archived-At: On 2023-07-09 09:24, Eli Zaretskii wrote: Thanks for your thorough review. Some follow-up comments and questions: > The reference to the file's name here is not necessary, and just makes > the text harder to read. This simpler variant doesn't seem to lose > any useful content: > > When you save a buffer to an encrypted file for the first time, > EasyPG Assistant presents you a list of keys in a buffer ... > >> +reads, since the gpg-agent caches your passphrase for file reads at >> +least for some time, but not for buffer saves. > > I think gpg-agent should be in @command (here and elsewhere), since > it's a shell command name. Yet another case where I tried to maintain consistency with the original manual: It uses gpg-agent rather consistently (without @command) where I probably would have used the proper name "GnuPG agent". In any case it means changing existing text, not simply adding new text ... >> For frequently visited files, it might be a good idea to tell Emacs >> -which encryption method should be used through @xref{File Variables, , >> -, emacs, the Emacs Manual}. Use the @code{epa-file-encrypt-to} local >> -variable for this. >> +which encryption method should be used through file variables >> +(@pxref{File Variables, , Local Variables in Files, emacs, The Emacs >> +Editor}). Use the @code{epa-file-encrypt-to} local variable for this. >> @vindex epa-file-encrypt-to > > This @vindex entry should be before the text describing the variable, > not after it. ... and same here. My real problem here is to fix minor issues present in the existing text and add my own changes in one commit, but you seem to be more relaxed here, so I will just do that. >> +also when you use Emacs remotely or from a text-only terminal. To >> +enable it: >> + >> +@enumerate >> +@item >> +Ensure that option @code{allow-loopback-pinentry} is configured for >> +gpg-agent, which should be the default. >> + >> +@item >> +Customize variable @code{epg-pinentry-mode} to @code{loopback} in >> +Emacs. >> +@end enumerate > > Shouldn't the two variables mentioned here be indexed? If they are > already indexed, but the index entries point to another place, having > a cross-reference here to that place is TRT. I thought that @vindex is somewhat reserved for Emacs variables that are defined with @defvar. So the variable index is more of an index for everything "variable-like"? >> +@c Make pinentry-emacs the default Pinentry by means of your operating >> +@c system. Install package pinentry.el from GNU ELPA and execute M-x >> +@c pinentry-start to start the Emacs Pinentry service. *All* GnuPG > > "M-x command" should be in @kbd. Even if the whole text is a comment or to be @ignored? In that case should I probably also use @command{pinentry-emacs}, @file{pinentry.el}, etc. in the quoted paragraph?