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#64154: 29.0.92; Provide additional details on GnuPG and EPA usage in epa.texi Date: Sat, 01 Jul 2023 09:01:36 +0300 Message-ID: <83a5wgrwzj.fsf@gnu.org> References: <83wn02r0s7.fsf@gnu.org> <90275992-b539-e611-d92b-9bfe57d9d58d@vodafonemail.de> <056aa3cb-51e6-dc01-a299-1200ba79e211@vodafonemail.de> <831qhtts01.fsf@gnu.org> <9e4c56f2-0124-fdf1-c719-ca6219c1ab28@vodafonemail.de> <3036a576-9260-8932-cb07-3941046f2dd8@vodafonemail.de> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="29681"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 64154@debbugs.gnu.org To: Jens Schmidt Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jul 01 08:02:30 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 1qFTgk-0007UV-FC for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 01 Jul 2023 08:02:30 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qFTgK-0002au-Eh; Sat, 01 Jul 2023 02:02:04 -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 1qFTgI-0002aE-Gz for bug-gnu-emacs@gnu.org; Sat, 01 Jul 2023 02:02: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 1qFTgI-0001jJ-83 for bug-gnu-emacs@gnu.org; Sat, 01 Jul 2023 02:02:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qFTgI-0007RN-3O for bug-gnu-emacs@gnu.org; Sat, 01 Jul 2023 02:02:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 01 Jul 2023 06:02:02 +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.168819127528478 (code B ref 64154); Sat, 01 Jul 2023 06:02:02 +0000 Original-Received: (at 64154) by debbugs.gnu.org; 1 Jul 2023 06:01:15 +0000 Original-Received: from localhost ([127.0.0.1]:56199 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qFTfX-0007PF-6Z for submit@debbugs.gnu.org; Sat, 01 Jul 2023 02:01:15 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:39408) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qFTfV-0007Oy-1V for 64154@debbugs.gnu.org; Sat, 01 Jul 2023 02:01:13 -0400 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 1qFTfO-0001YC-NT; Sat, 01 Jul 2023 02:01:06 -0400 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=yBvgb/xPdAq30CdIYvKr5oPdSJNvckE72nBnYoTZwDk=; b=YG7/hxc65MET DnzYxdb5NMuX8GRawHnrrP5shB+a6Gic2STEXJj4BldjcDsDtF5h4V/5dURhqYUOcXQg0FztCs3X7 tgimG5gMkn3dJQ1rsy7YzqvDuSxv6nqNWJyhW4A6/ee4n4OCmTdHwMO8IgrzNylA83RG3QlcZ96r6 y2yhRyyMaxIkO4azqlUyY9z/4EXIJXuV07FTbBszByAlu2nFEzu2kCDtCk9R7hY/eK9DVHzIYNGLq RL7IvdVaZHq2WFqW8PKB/U/pIAAdTB8fvQO69DkgW2mwbwM4Y+L8vcyHTWVHpR8XUE7yKDqMbGDpZ RRvlZ/tRYUJYQK7Slz6xqA==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qFTfM-0006Cw-V3; Sat, 01 Jul 2023 02:01:06 -0400 In-Reply-To: <3036a576-9260-8932-cb07-3941046f2dd8@vodafonemail.de> (message from Jens Schmidt on Fri, 30 Jun 2023 22:54:11 +0200) 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:264352 Archived-At: > Date: Fri, 30 Jun 2023 22:54:11 +0200 > From: Jens Schmidt > Cc: 64154@debbugs.gnu.org > > >>> Yes, please. A manual that lacks Concept Index is not a good > >>> manual, IMO. In fact, Concept Index should be the very first > >>> index in a manual; there are some good manuals which have only > >>> that and nothing else. > > Here you go: Concept index added, structure titles title-cased. Please > check. Thanks, see some comments below. > @node Top > -@top EasyPG Assistant user's manual > +@top EasyPG Assistant User's Manual > +@cindex easypg assistant > +@cindex easypg It is not useful to have several index entries starting with the same substring and pointing to the same place. For example, here, you only need "@cindex easypg assistant", the "@cindex easypg" one is redundant. > +@cindex overview > +@cindex feature overview > +@cindex features Likewise here. Moreover, these index entries are too general. Think about the case of someone doing "M-x info-apropos", in which case they get index entries from many different manuals. Thus @cindex easypg assistant features is more useful. > @node Quick start > -@chapter Quick start > +@chapter Quick Start > +@cindex quick start > +@cindex introduction Same here: "introduction to easypg assistant" is more useful. > @node Commands > @chapter Commands > +@cindex commands And here, and elsewhere in this manual. > @node Key management > -@section Key management > +@section Key Management > +@cindex key management > +@cindex key ring > + > +@cindex browse key ring The "@cindex key ring" is redundant, given the other two. > +@cindex browse private key ring > @noindent > To browse your private keyring, use @kbd{M-x epa-list-secret-keys}. Here, I'd use "@cindex private key ring", unless that rin is described in another section. > +@cindex insert key > @deffn Command epa-insert-keys keys "@cindex insert keys" is better. > +@cindex import key > @deffn Command epa-import-keys file Likewise here: "keys". > +@cindex delete key > @deffn Command epa-delete-keys allow-secret And here. > @node Cryptographic operations on files > -@section Cryptographic operations on files > +@section Cryptographic Operations on Files > +@cindex cryptographic operations on files > +@cindex file operations I'd change the last one to "@cindex file operations, cryptographic", to make it less general. > @node Mail-mode integration > -@section Mail-mode integration > +@section Mail-Mode Integration > +@cindex mail-mode integration > +@cindex sending signed mails > +@cindex sending encrypted mails I'd make one index entry from the last two: @cindex sending encrypted/signed mails > @node Querying a key server > -@section Querying a key server > +@section Querying a Key Server > +@cindex querying key server > +@cindex query key server > +@cindex key server I'd keep only the first index entry here, the other two are redundant. > @node GnuPG version compatibility > -@chapter GnuPG version compatibility > +@chapter GnuPG Version Compatibility > +@cindex gnupg version compatibility > +@cindex version compatibility > +@cindex compatibility Likewise here. You need to remember that typing "i compatibility" in the Info reader will find the "gnupg version compatibility" entry, because Info-index uses substring search in the indices. > @node Caching Passphrases > @chapter Caching Passphrases > +@cindex caching passphrases > +@cindex entering passphrases > +@cindex passphrase cache > +@cindex passphrases Here, I'd lose the "@cindex passphrase cache", as the other entries cover it.