@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
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>
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