[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Mailcrypt requires version 19 or higher of GNU Emacs. Mailcrypt has been tested on a variety of systems under both FSF Emacs and XEmacs.
Mailcrypt requires Pretty Good (tm) Privacy, usually known as PGP. This document assumes that you have already obtained and installed PGP and that you are familiar with its basic functions. The best way to become familiar with these functions is to read the PGP User's Guide, at least Volume I.
For more information on obtaining and installing PGP, refer to the MIT PGP home page at `http://web.mit.edu/network/pgp.html'.
Although Mailcrypt may be used to process data in arbitrary Emacs buffers, it is most useful in conjunction with other Emacs packages for handling mail and news. Mailcrypt has specialized support for Rmail (see Rmail: (emacs)Rmail section `Reading Mail with Rmail' in The GNU Emacs Manual), VM (see VM: (vm)Top section `Introduction' in The VM User's Manual), MH-E, and Gnus (see Gnus: (gnus)Top section `Overview' in The Gnus Manual). Information on the general use of these packages is beyond the scope of this manual.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If Mailcrypt is not installed on your system, obtain the latest version from the Mailcrypt home page at `http://mailcrypt.sourceforge.net' and follow the instructions in the file `INSTALL'.
Next, decide what version of PGP you are using. Versions 3.5 and higher of Mailcrypt support multiple versions of PGP. To choose a version, add the following lines to your `.emacs' file:
(load-library "mailcrypt") ; provides "mc-setversion" (mc-setversion "2.6") ; for PGP 2.6 (default); also "5.0" and "gpg" |
Next, teach your Emacs how and when to load the Mailcrypt functions and install the Mailcrypt key bindings. Almost all Emacs major modes (including mail and news handling modes) have corresponding "hook" variables which hold functions to be run when the mode is entered. All you have to do is add the Mailcrypt installer functions to the appropriate hooks; then the installer functions will add the Mailcrypt key bindings when the respective mode is entered.
Specifically, begin by placing the following lines into your `.emacs' file (or the system-wide `default.el' file):
(autoload 'mc-install-write-mode "mailcrypt" nil t) (autoload 'mc-install-read-mode "mailcrypt" nil t) (add-hook 'mail-mode-hook 'mc-install-write-mode) |
Then add additional lines for your own mail and news packages as described below.
1.2.1 Hooking into Rmail | ||
1.2.2 Hooking into VM | ||
1.2.3 Hooking into MH-E | ||
1.2.4 Hooking into Gnus | ||
1.2.5 Hooking into Mew |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
To hook Mailcrypt into Rmail, use the following lines:
(add-hook 'rmail-mode-hook 'mc-install-read-mode) (add-hook 'rmail-summary-mode-hook 'mc-install-read-mode) |
Using Emacs version 20.3 or higher, you should use the following lines instead:
(add-hook 'rmail-show-message-hook 'mc-install-read-mode) (add-hook 'rmail-summary-mode-hook 'mc-install-read-mode) |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
To hook Mailcrypt into VM, use the following lines:
(add-hook 'vm-mode-hook 'mc-install-read-mode) (add-hook 'vm-summary-mode-hook 'mc-install-read-mode) (add-hook 'vm-virtual-mode-hook 'mc-install-read-mode) (add-hook 'vm-mail-mode-hook 'mc-install-write-mode) |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
To hook Mailcrypt into MH-E, use the following lines:
(add-hook 'mh-folder-mode-hook 'mc-install-read-mode) (add-hook 'mh-letter-mode-hook 'mc-install-write-mode) |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
To hook Mailcrypt into Gnus, use the following lines:
(add-hook 'gnus-summary-mode-hook 'mc-install-read-mode) (add-hook 'message-mode-hook 'mc-install-write-mode) (add-hook 'news-reply-mode-hook 'mc-install-write-mode) |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
To hook Mailcrypt into Mew, use the following lines:
(add-hook 'mew-message-mode-hook 'mc-install-read-mode) (add-hook 'mew-summary-mode-hook 'mc-install-read-mode) (add-hook 'mew-draft-mode-hook 'mc-install-write-mode) |
Note that Mew already has extensive support for MIME-encoded encrypted and/or signed messages (using the "multipart/encrypted" and "application/pgp-encrypted" formats specified by RFC3156). Using MailCrypt within Mew is most useful for traditional "inline" armored encrypted/signed messages.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
All Mailcrypt commands are (by default) activated by three-character key sequences which begin with C-c /. The most common operations are:
C-c / e encrypts a message using the recipient's (or recipients') public key(s). See section Encrypting a Message.
C-c / d decrypts a message using your secret key. See section Decrypting a Message.
C-c / s clearsigns a message using your secret key. See section Signing a Message.
C-c / v verifies the signature on a clearsigned message using the sender's public key. See section Verifying a Signature.
These functions and others are documented in detail in the following chapters.
Any time you are composing or reading mail or news, you can get a
summary of the available commands by typing C-h m. If you are
running Emacs under X, an even easier way to see the available commands
is to access the Mailcrypt
pull-down menu.
[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated on August, 12 2007 using texi2html 1.76.