# HG changeset patch
# User Daiki Ueno <ueno@unixuser.org>
# Date 1286349162 -32400
# Node ID 1a4e0055489faa0dc417b6b2c1d2baba3ed79bdb
# Parent  9a3ce1aa9d45956d5298141ca46d6748e5f3c4db
* epa.texi (Caching Passphrases): New section.

diff -r 9a3ce1aa9d45 -r 1a4e0055489f doc/misc/ChangeLog
--- a/doc/misc/ChangeLog	Tue Oct 05 21:20:46 2010 -0700
+++ b/doc/misc/ChangeLog	Wed Oct 06 16:12:42 2010 +0900
@@ -1,3 +1,7 @@
+2010-10-06  Daiki Ueno  <ueno@unixuser.org>
+
+	* epa.texi (Caching Passphrases): New section.
+
 2010-10-06  Glenn Morris  <rgm@gnu.org>
 
 	* Makefile.in (SHELL): Set it.
diff -r 9a3ce1aa9d45 -r 1a4e0055489f doc/misc/epa.texi
--- a/doc/misc/epa.texi	Tue Oct 05 21:20:46 2010 -0700
+++ b/doc/misc/epa.texi	Wed Oct 06 16:12:42 2010 +0900
@@ -66,6 +66,7 @@
 * Overview::                    
 * Quick start::                 
 * Commands::                    
+* Caching Passphrases::         
 * Bug Reports::                 
 @end menu
 
@@ -399,6 +400,43 @@
 The default value is @code{t}.
 @end defvar
 
+@node Caching Passphrases
+@chapter Caching Passphrases
+
+Typing passphrases is an irritating task if you frequently open and
+close the same file.  GnuPG and EasyPG Assistant provide mechanisms to
+remember your passphrases.  However, the configuration is a bit
+confusing since it depends on your GnuPG installation (GnuPG version 1 or
+GnuPG version 2), encryption method (symmetric or public key), and whether or
+not you want to use gpg-agent.  Here are some questions:
+
+@enumerate
+@item Do you use GnuPG version 2 instead of GnuPG version 1?
+@item Do you use symmetric encryption rather than public key encryption?
+@item Do you want to use gpg-agent?
+@end enumerate
+
+Here are configurations depending on your answers:
+
+@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 No @tab You can't, without gpg-agent.
+@item Yes @tab No @tab Yes @tab Nothing to do.
+@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 No @tab You can't, without gpg-agent.
+@end multitable
+
+To setup gpg-agent, follow the instruction in GnuPG manual.
+@pxref{Invoking GPG-AGENT, , Invoking GPG-AGENT, gnupg}.
+
+To set up elisp passphrase cache, set
+@code{epa-file-cache-passphrase-for-symmetric-encryption}.
+@xref{Encrypting/decrypting *.gpg files}.
+
 @node Bug Reports
 @chapter Bug Reports