Update.
authorueno <ueno>
Tue, 20 Mar 2007 08:29:06 +0000 (08:29 +0000)
committerueno <ueno>
Tue, 20 Mar 2007 08:29:06 +0000 (08:29 +0000)
epa.texi

index 25b5315..feb1bd3 100644 (file)
--- a/epa.texi
+++ b/epa.texi
@@ -123,10 +123,13 @@ M-x dired
 
 @node Keyring browser
 @section Keyring browser
+Probably the first step of using EasyPG Assistant is to browse your
+keyring.  @kbd{M-x epa-list-keys} is corresponding to @samp{gpg
+--list-keys} from the command line.
 
-@deffn Command epa-list-keys &optional name mode
-Show all keys matched with NAME from the keyring.
-If MODE is non-nil, it reads the private keyring.  Otherwise, it
+@deffn Command epa-list-keys name mode
+Show all keys matched with @var{name} from the keyring.
+If @var{mode} is non-nil, it reads the private keyring.  Otherwise, it
 reads the public keyring.
 @end deffn
 
@@ -136,9 +139,13 @@ The output looks as follows.
   u A5B6B2D4B15813FE Daiki Ueno <ueno@@unixuser.org>
 @end example
 
+A character on the leftmost column indicates the trust level of the
+key.  If it is @samp{u}, the key is marked as ultimately trusted.  The
+second column is the key ID, and the rest is the user ID.
+
 You can move over entries by @kbd{TAB}.  If you type @kbd{RET} or
-clicked an entry, you will see more detailed information about the key
-you selected.
+clicked button1 on an entry, you will see more detailed information
+about the key you selected.
 
 @example
  u Daiki Ueno <ueno@@unixuser.org>
@@ -154,9 +161,39 @@ you selected.
        Fingerprint: 9003 D76B 73B7 4A8A E588  10AF 4447 461B 2A9B EA2D
 @end example
 
+In the @samp{*Keys*} buffer, several commands are available.  The
+common use case is to export some keys to a file.  To do that, type
+@kbd{m} to select keys, type @kbd{o}, and then supply the filename.
+
 @node Cryptographic operations on regions
 @section Cryptographic operations on regions
-(not yet written.)
+
+@deffn Command epa-decrypt-region start end
+Decrypt the current region between @var{start} and @var{end}.  It
+replaces the region with the decrypted plaintext.
+@end deffn
+
+@deffn Command epa-decrypt-armor-in-region start end
+Decrypt OpenPGP armors in the current region between @var{start} and
+@var{end}.  The difference from epa-decrypt-region is that
+epa-decrypt-armor-in-region searches ASCII armors in the region and
+applies epa-decrypt-region to each of them.  That is, this command
+does not alter the original text around ASCII armors.
+@end deffn
+
+@deffn Command epa-verify-region start end
+Verify the current region between @var{start} and @var{end}.  It sends
+the verification result to the minibuffer.
+@end deffn
+
+@deffn Command epa-verify-cleartext-in-region
+Verify OpenPGP cleartext signed messages in the current region between
+@var{start} and @var{end}.  The difference from epa-verify-region is
+that epa-verify-cleartext-in-region searches OpenPGP cleartext
+segments in the region and applies epa-verify-region to each of them.
+That is, this command does not alter the original text around OpenPGP
+cleartext segments.
+@end deffn
 
 @node Cryptographic operations on files
 @section Cryptographic operations on files