@set VERSION 1.0.0
@copying
-This file describes EasyPG Assistant.
+This file describes EasyPG Assistant @value{VERSION}.
-Copyright @copyright{} 2007, 2008 Free Software Foundation, Inc.
+Copyright @copyright{} 2007, 2008, 2009 Free Software Foundation, Inc.
@quotation
Permission is granted to copy, distribute and/or modify this document
* EasyPG Assistant: (epa). An Emacs user interface to GNU Privacy Guard.
@end direntry
-
@titlepage
@title EasyPG Assistant
@vskip 0pt plus 1filll
@insertcopying
@end titlepage
-@page
-@c @summarycontents
-@c @contents
+@contents
@node Top
@top EasyPG Assistant user's manual
GnuPG interface for Emacs. EasyPG also contains the library interface
called EasyPG Library.
-@noindent
-This manual covers EasyPG version @value{VERSION}.
+@ifnottex
+@insertcopying
+@end ifnottex
@menu
* Overview::
integrated into other Emacs functionalities. For example, automatic
encryption/decryption of @samp{*.gpg} files.
-To install these features, do @kbd{C-u 1 M-x epa-mode}. It can also
-be turned on by customize. Try @kbd{M-x customize-variable epa-mode}.
-
@node Commands
@chapter Commands
@node Mail-mode integration
@section Mail-mode integration
-EasyPG Assistant provides a minor mode to help user compose inline PGP
-messages. Inline PGP is sending the OpenPGP blobs directly inside a
-mail message and it is not recommended and you should consider to use
+EasyPG Assistant provides a minor mode @code{epa-mail-mode} to help
+user compose inline PGP messages. Inline PGP is a traditional style
+of sending signed/encrypted emails by embedding raw OpenPGP blobs
+inside a message body, not using modern MIME format.
+
+NOTE: Inline PGP is not recommended and you should consider to use
PGP/MIME. See
@uref{http://josefsson.org/inline-openpgp-considered-harmful.html,
Inline PGP in E-mail is bad, Mm'kay?}.
@noindent
-The following keys are assigned.
+Once @code{epa-mail-mode} is enabled, the following keys are assigned.
+You can do it by @kbd{C-u 1 M-x epa-mail-mode} or through the Customize
+interface. Try @kbd{M-x customize-variable epa-global-mail-mode}.
@table @kbd
@item C-c C-e d
@kindex @kbd{C-c C-e e}
@findex epa-mail-encrypt
Compose an encrypted message from the current buffer.
+By default it tries to build the recipient list from @samp{to},
+@samp{cc}, and @samp{bcc} fields of the mail header. To include your
+key in the recipient list, use @samp{encrypt-to} option in
+@file{~/.gnupg/gpg.conf}.
@end table
@node Encrypting/decrypting *.gpg files
@section Encrypting/decrypting *.gpg files
-Once @code{epa-setup} is loaded, every file whose extension is
-@samp{.gpg} will be treated as encrypted. That is, when you attempt
-to open such a file which already exists, the decrypted text is
-inserted in the buffer rather than encrypted one. On the other hand,
-when you attempt to save the buffer to a file whose extension is
-@samp{.gpg}, encrypted data is written.
+By default, every file whose extension is @samp{.gpg} will be treated
+as encrypted. That is, when you attempt to open such a file which
+already exists, the decrypted text is inserted in the buffer rather
+than encrypted one. On the other hand, when you attempt to save the
+buffer to a file whose extension is @samp{.gpg}, encrypted data is
+written.
If you want to temporarily disable this behavior, use @kbd{M-x
epa-file-disable}, and then to enable this behavior use @kbd{M-x