changeset 110933:7c7fd71d22c7

Clarify the doc about caching passphrases. * epa.texi (Caching Passphrases): * auth.texi (GnuPG and EasyPG Assistant Configuration): Clarify some configurations require to set up gpg-agent.
author Daiki Ueno <ueno@unixuser.org>
date Tue, 12 Oct 2010 10:49:05 +0900
parents 0d72a05fef14
children a36fccf2a365
files doc/misc/ChangeLog doc/misc/auth.texi doc/misc/epa.texi
diffstat 3 files changed, 22 insertions(+), 16 deletions(-) [+]
line wrap: on
line diff
--- a/doc/misc/ChangeLog	Tue Oct 12 00:25:50 2010 +0000
+++ b/doc/misc/ChangeLog	Tue Oct 12 10:49:05 2010 +0900
@@ -1,3 +1,9 @@
+2010-10-12  Daiki Ueno  <ueno@unixuser.org>
+
+	* epa.texi (Caching Passphrases):
+	* auth.texi (GnuPG and EasyPG Assistant Configuration): Clarify
+	some configurations require to set up gpg-agent.
+
 2010-10-11  Glenn Morris  <rgm@gnu.org>
 
 	* Makefile.in (.texi.dvi): Remove unnecessary suffix rule.
--- a/doc/misc/auth.texi	Tue Oct 12 00:25:50 2010 +0000
+++ b/doc/misc/auth.texi	Tue Oct 12 10:49:05 2010 +0900
@@ -267,24 +267,24 @@
 @node GnuPG and EasyPG Assistant Configuration
 @appendix GnuPG and EasyPG Assistant Configuration
 
+If you don't customize @code{auth-sources}, the auth-source library
+reads @code{~/.authinfo.gpg}, which is a GnuPG encrypted file.
+
 In Emacs 23 or later there is an option @code{auto-encryption-mode} to
-automatically decrypt @code{*.gpg} files and it is enabled by default
-so there is no setting is needed.  If you are using earlier versions
-of Emacs for some reason, you will need:
+automatically decrypt @code{*.gpg} files.  It is enabled by default so
+there is no setting is needed.  If you are using earlier versions of
+Emacs, you will need:
 
 @lisp
 (require 'epa-file)
 (epa-file-enable)
 @end lisp
 
-If you want your GnuPG passwords to be cached, setup @code{gpg-agent}
+If you want your GnuPG passwords to be cached, set up @code{gpg-agent}
 or EasyPG Assitant
 @pxref{Caching Passphrases, , Caching Passphrases, epa}
 
-For those who are using older vesions of Emacs, here are some portion
-copied from the EasyPG Assitant manual:
-
-Here are some questions:
+To quick start, here are some questions:
 
 @enumerate
 @item Do you use GnuPG version 2 instead of GnuPG version 1?
@@ -296,17 +296,17 @@
 
 @multitable {111} {222} {333} {configuration configuration configuration}
 @item @b{1} @tab @b{2} @tab @b{3} @tab Configuration
-@item Yes @tab Yes @tab Yes @tab Nothing to do.
+@item Yes @tab Yes @tab Yes @tab Set up gpg-agent.
 @item Yes @tab Yes @tab No @tab You can't, without gpg-agent.
-@item Yes @tab No @tab Yes @tab Nothing to do.
+@item Yes @tab No @tab Yes @tab Set up gpg-agent.
 @item Yes @tab No @tab No @tab You can't, without gpg-agent.
 @item No @tab Yes @tab Yes @tab Set up elisp passphrase cache.
 @item No @tab Yes @tab No @tab Set up elisp passphrase cache.
-@item No @tab No @tab Yes @tab Nothing to do.
+@item No @tab No @tab Yes @tab Set up gpg-agent.
 @item No @tab No @tab No @tab You can't, without gpg-agent.
 @end multitable
 
-To setup gpg-agent, follow the instruction in GnuPG manual.
+To set up gpg-agent, follow the instruction in GnuPG manual.
 @pxref{Invoking GPG-AGENT, , Invoking GPG-AGENT, gnupg}.
 
 To set up elisp passphrase cache, set
--- a/doc/misc/epa.texi	Tue Oct 12 00:25:50 2010 +0000
+++ b/doc/misc/epa.texi	Tue Oct 12 10:49:05 2010 +0900
@@ -420,17 +420,17 @@
 
 @multitable {111} {222} {333} {configuration configuration configuration}
 @item @b{1} @tab @b{2} @tab @b{3} @tab Configuration
-@item Yes @tab Yes @tab Yes @tab Nothing to do.
+@item Yes @tab Yes @tab Yes @tab Set up gpg-agent.
 @item Yes @tab Yes @tab No @tab You can't, without gpg-agent.
-@item Yes @tab No @tab Yes @tab Nothing to do.
+@item Yes @tab No @tab Yes @tab Set up gpg-agent.
 @item Yes @tab No @tab No @tab You can't, without gpg-agent.
 @item No @tab Yes @tab Yes @tab Set up elisp passphrase cache.
 @item No @tab Yes @tab No @tab Set up elisp passphrase cache.
-@item No @tab No @tab Yes @tab Nothing to do.
+@item No @tab No @tab Yes @tab Set up gpg-agent.
 @item No @tab No @tab No @tab You can't, without gpg-agent.
 @end multitable
 
-To setup gpg-agent, follow the instruction in GnuPG manual.
+To set up gpg-agent, follow the instruction in GnuPG manual.
 @pxref{Invoking GPG-AGENT, , Invoking GPG-AGENT, gnupg}.
 
 To set up elisp passphrase cache, set